What’s Supported

Supported Actions

This connector supports:

  • Read Actions, including full historic backfill. Please note that incremental read is not supported, a full read of the DynamicsCRM instance will be done for each scheduled read.
  • Write Actions.
  • Proxy Actions, using the base URL https://{{.workspace}}.api.crm.dynamics.com/api/data.

Supported Objects

The Microsoft’s DynamicsCRM connector supports reading from and writing to all the available objects in the Microsoft Dynamics 365 Sales module, which totals to more than 1000 objects and include:

Example Integration

For an example manifest file of an Dynamics CRM integration, visit our samples repo on Github.

Before You Get Started

To connect Microsoft Dynamics 365 CRM with Ampersand, you will need an active Microsoft Dynamics 365 CRM Account.

Once your account is set up, you’ll need to register an application in the Microsoft Entra developer portal. After registering your app, you will need to configure it and obtain the following credentials:

  • Application (client) ID
  • Client Secret

You will then use these credentials to connect Dynamics 365 CRM to Ampersand.

Create a Microsoft Dynamics 365 CRM Account

Here’s how you can sign up for a Microsoft Dynamics 365 CRM account:

Register a Microsoft Dynamics 365 CRM App

Follow the steps below to register a Microsoft Dynamics 365 CRM app:

  1. Go to the Microsoft Azure portal and sign in with an administrator account from your Microsoft 365 subscription.
  2. On the Home page, under Azure services, select Microsoft Entra ID.
  3. In the left navigation pane, select App registrations.
  4. Click + New registration.
  5. Enter Application Details:
    • Name: Enter a meaningful name for the application.
    • Supported account types: Select Accounts in any or this organizational directory.
  6. In the Redirect URIs section, enter the Ampersand redirect URL: https://api.withampersand.com/callbacks/v1/oauth.
  7. In the left navigation panel, select API permissions > Add a permission.
  8. Under the APIs my organization uses tab, select Microsoft Dynamics 365 CRM.
  9. Select the applicable permissions.

Obtain Client ID and Client Secret

  1. On the Overview page, you’ll find the Application (client) ID. Copy it.
  2. In the left navigation pane, select Certificates & secrets.
  3. Click + New client secret, provide a description and expiration period, then click Add. Copy the client secret value.

Add Your Dynamics 365 CRM App Info to Ampersand

  1. Log in to your Ampersand Dashboard.

  2. Select the project where you want to create a Dynamics 365 CRM integration.

  3. Select Provider Apps.

  4. Select Dynamics 365 from the Provider list.

  5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field.

  6. Click Save Changes.

Using the connector

To start integrating with Dynamics CRM: