Dynamics Integration Setup Guide

Microsoft Dynamics is a suite of enterprise tools for CRM.

Integrations can only be set up by Admin users and are enabled per team. See our General Integration Information page for an overview of integrations and some recommendations when configuring new integrations.

Required Setup

Configuring the Dynamics integration requires a registered Dynamics Client Secret and Client ID, which are used to authenticate a secure connection. Set up will require a Microsoft login and password from an Azure admin.

Once you have the Client Secret and Client ID from the steps below, fill out the secure Dynamics Credential Submission form. We’ll contact you once the integration is ready to use.

How to create the Client Secret

  1. Start from your Microsoft Azure Portal at https://portal.azure.com.
  2. Select Azure Active Directory on the left sidebar.
  3. Select App registrations in the panel that opens up.
  4. Select New registration at the top of the new panel.

    screen readers look here
  5. In the “Register an application” page, fill in the following fields:
    • Name: workflow-dynamics-integration
    • Supported Account Types: Accounts in this organizational directory (Single Tenant)
    • Redirect URI: https://security.pushbot.com/oauth

    💡Tip: Make sure the Redirect URI drop-down stays set to Web

  6. Select Register.

    screen readers look here
  7. After the app registers, select it on the app registrations page.

    screen readers look here
  8. Select API permissions in the left side bar.
  9. Select Add a permission in the panel that opens up.

    screen readers look here
  10. Scroll down, and select Dynamics from the list of available APIs.

    screen readers look here
  11. Select Delegated permissions
  12. Scroll down, and select user_impersonation
  13. Select Add permissions

    screen readers look here
  14. Select Certificates & Secrets in the left side bar
  15. Give the secret a description, such as: catalyticsecretkey.
  16. Set Expires to Never
  17. Select Add

    screen readers look here
  18. At the bottom of the next page, the Client Secret is revealed. This key is only shown once, so copy it before leaving the page.

    screen readers look here

How to find the Client ID

With the app registered, select Overview in the left sidebar. The Client ID is shown next to the display name.

screen readers look here

Create Integration

Once you have the Client Secret and Client ID, you are ready to integrate! To finish the integration, fill out the Dynamics Credential Submission form.

We’ll then contact you once the integration is ready for you to use. Once complete, the Dynamics integration will be ready to finalize.

The following instructions are for creating an integration for the first time. If you already have a connection, select the integration and select Add a Connection, or see How to create a new connection for an existing integration.

  1. Open the overflow menu in the top navigation bar, and select Admin.
  2. Select Integrations at the bottom of the page.
  3. Select the Add an Integration button in the top right corner.
  4. Select Dynamics integration then select Add this Connection.
  5. Fill in the details. Set the integration permissions if necessary.

    ⚠️ Heads-up: The Dynamics account you choose to connect with must be part of your organization and have access to Microsoft Dynamics. If you’re logged into multiple Microsoft accounts, it’s recommended to log out of all but one account.

  6. Select Connect.
  7. It will redirect to a Microsoft login page where your Azure admin must log in to connect.
  8. After authorizing or logging into your Microsoft account, the integration is ready to go and you’ll be returned back to Catalytic.