> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Microsoft Dynamics CRM Source

<Note>
  **Note:**

  *Refer to [Microsoft Dynamics CRM Source](/articles/integrate-customer/ms-dynamics-source) to know more about this source.*
</Note>

## Prerequisites

Ensure that register an App in your Dynamics 365 instance and keep the following details handy before creating a source in Zeotap CDP:

* App Client ID
* Tenant ID
* App Client Secret
* Organization URL

### Step 1: Obtain App Client ID, Tenant ID and App Client Secret

Perform the following steps to register an app and generate the App Client ID and Tenant ID:

<Steps>
  <Step>
    Log into the [Azure portal](https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize?redirect_uri=https%3A%2F%2Fportal.azure.com%2Fsignin%2Findex%2F\&response_type=code%20id_token\&scope=https%3A%2F%2Fmanagement.core.windows.net%2F%2Fuser_impersonation%20openid%20email%20profile\&state=OpenIdConnect.AuthenticationProperties%3DN5Vtawk2FeJ_AzXoNOiRYoHhyVKINMdlhcsuzzCKuAE3eAVl_hZQeqRbLYqOWZ-Lmy9F4oVfZGP6Wqio9s0yxFgBO2Pqf6WQ3MnZhaqhrSyqXqBALV2c3CjbHL_dYRkPS0aBpyXkiqW59Z9hr77Guks5Dt_QXeacZ3DG4E5UytbGyYLNj8Wrm56pMQNCRE-FfpKQxa-aQ5XuM86Rng8UtKYDdat19c8vU8g-3KSymQzav5rD8AvtXdS72U-ejPKZuzzxGAwumSxlB75gCh0C736oNOExIeKH_Kx89ZL-t9NvW22LcelifUd3TakL9Dhq22cIMic-mTG1ilHz6fBOfCJ4ptGkEBEiqtU4Nxts7ODvqJKaWHjpFgDg1x883pMvRl25B-Mg8vw0hXorC5QHtLOGaSjkOatjPaMCPbsKu-Np1OOfOOKn5yXxokM3qkNjVoG2QLCj1wiTlwD6mj0On6TzwDuhutrho7MyOywhTgc\&response_mode=form_post\&nonce=638623240557455114.ZjIyNGJhZTktYzkwOC00MjI2LWE3ZGYtNTIxYWY3YTNkNTUxYzE1ZjQ4YjctMDEzYS00YTMzLTg3MmUtODA2MzkwNjMxZTM2\&client_id=c44b4083-3bb0-49c1-b47d-974e53cbdf3c\&site_id=501430\&client-request-id=11dbc1fb-cbe4-45d7-b71a-4a944bdfe2c6\&x-client-SKU=ID_NET472\&x-client-ver=7.5.0.0).
  </Step>

  <Step>
    On the homepage, select **App Registration** > **New Registration**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-1.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=e3572a4cd5d4ba0ac7b2943d7c1a4d8f" width="1600" height="1330" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-1.png" />
    </Frame>
  </Step>

  <Step>
    In the Application Registration form, provide the following information:

    * Under **Name**, enter a meaningful name for the registration app.
    * Under **Supported Account Types**, select **Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant)** using the radio button as shown in the image below.
    * Leave the redirect URL blank.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-2.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=9d2fc32b25a7a5b87001d13e599aea20" width="1511" height="1336" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-2.png" />
    </Frame>
  </Step>

  <Step>
    Select **Register**.
    Once the App is registered, you can copy the values displayed for Application (client) ID and Directory (tenant) ID. These values are required for integrating MS Dynamics with Zeotap CDP.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-3.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=9f88dc2cea593161c4f7c3ddc74663d8" width="1400" height="649" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-3.png" />
    </Frame>
  </Step>

  <Step>
    Next, you must provide the necessary permissions for the API. To do so, in the left navigation panel, click **API Permissions**.
  </Step>

  <Step>
    In the new screen that appears, under the **Microsoft APIs** tab, click **Dynamics CRM**.
  </Step>

  <Step>
    In the **Request API permissions** screen that appears, click **Delegated Permissions.**
  </Step>

  <Step>
    Under **Select permissions**, use the checkbox to select the **user\_impersonation** permission and click **Add permissions**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-4.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=f26eca3c4312ca524fd44de2ba9ab6b2" width="827" height="715" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-4.png" />
    </Frame>
  </Step>

  <Step>
    Next, in the left navigation panel, go to **Certificates & secrets > New client secret**.
  </Step>

  <Step>
    In the new window that appears, provide the following details:

    a. In the **Description** field, enter a short description for the client secret.

    b. For **Expires**, choose the validity of the client secret using the drop-down menu.

    c. Click **Add**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-5.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=2a8dbbcd7bdd78b911e2b803ec9660c7" width="588" height="265" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-5.png" />
    </Frame>
  </Step>

  <Step>
    To find the client secret added, in the left navigation panel, click **Certificates & secrets** and go to the **Client secrets** tab as shown below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-6.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=bf642c7702f2ff6c90ef9a2a8e3d117b" width="1044" height="309" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-6.png" />
    </Frame>
  </Step>

  <Step>
    Copy the value displayed under **Value.** This is the App Client Secret required when creating a MS Dynamics CRM source in Zeotap CDP. The value is shown only once, so copy and save it securely.
  </Step>

  <Step>
    As a final step, navigate again to **API permissions** and click **Grant admin consent** as shown below. This completes the App registration process on MS Dynamics.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-7.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=aa9d584431ccfb8eaf44526e1b2a460a" width="1304" height="711" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-7.png" />
    </Frame>
  </Step>
</Steps>

### Step 2: Grant Dynamics 365 App Permissions in Power Automate Portal

<Steps>
  <Step>
    Log into the Power Automate portal at [https://admin.powerplatform.microsoft.com/](https://admin.powerplatform.microsoft.com/).
  </Step>

  <Step>
    In the left navigation panel, click **Environments** and then choose the environment where your Dynamics CRM is located as shown below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-8.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=d427cdbc1cf861bff06dbc4b85628389" width="881" height="469" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-8.png" />
    </Frame>
  </Step>

  <Step>
    Click **Settings**. Under **Details**, find the Environmental URL as shown in the image below. This is the Organizational URL required when creating the MS Dynamics CRM source in Zeotap CDP.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-9.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=3b3d94089fb83a2f9e5db1a938b97011" width="1131" height="459" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-9.png" />
    </Frame>
  </Step>

  <Step>
    Next, under **Users + permissions**, click **Application users**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-10.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=e836154113165dbc1d09d2cfe288b32d" width="1219" height="629" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-10.png" />
    </Frame>
  </Step>

  <Step>
    In the new screen that appears, click **+ New app user.**
  </Step>

  <Step>
    In the **Create a new app user** window, under App, choose the Business unit using the drop-down menu and then click **+ Add an app**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-11.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=7accffe482f429f715fc223690c718b4" width="1264" height="677" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-11.png" />
    </Frame>
  </Step>

  <Step>
    In the new window that appears, search for the app that you registered earlier and click **Add**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-12.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=ddb4fd428fb330592385cf2184013318" width="1253" height="930" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-12.png" />
    </Frame>
  </Step>

  <Step>
    Once done, you will be taken back to **Create a new app user** window. Next to **Security Roles**, select the **Edit** icon as shown below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-14.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=b8d99e9fbe1e308bd4a6fd2e56139b66" width="493" height="378" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-14.png" />
    </Frame>
  </Step>

  <Step>
    Provide the following permissions for your App:

    * **Basic User**
    * **Service Reader**
  </Step>

  <Step>
    Once done, click **Save** and then click **Create**. After a few seconds, you will see your app user listed. This completes the configuration part. Next, you need to create an MS Dynamics source in Zeotap CDP.
  </Step>
</Steps>

## Create an MS Dynamics Source in Zeotap CDP

Perform the following steps to create a Salesforce CRM Source in the Zeotap CDP App:

<Steps>
  <Step>
    Navigate to the Sources application in the Zeotap CDP App.
  </Step>

  <Step>
    Click **CREATE SOURCE**.
  </Step>

  <Step>
    Choose **CRM Data** as the **Category**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-15.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=cb7f6b92184f919002e232faf43c2805" width="3554" height="1974" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-15.png" />
    </Frame>
  </Step>

  <Step>
    Click **Microsoft Dynamics CRM** at the **Data Source**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-17.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=fdb9f3aa89dba8b073c8b5d79ffc59e0" width="3574" height="1784" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-17.png" />
    </Frame>
  </Step>

  <Step>
    In the window that appears, enter a short and descriptive name for the source.
  </Step>

  <Step>
    Select the Region of upload.
  </Step>

  <Step>
    Enter the App Client ID, App Client Secret, Tenant ID and Organisational URL obtained from the Azure portal in the respective fields. For more information about how to obtain these values, refer to the [Prerequisites section](#prerequisites).
  </Step>

  <Step>
    Provide the desired **Entity** name. For example, account, campaign and incident (case) can be used to track and support sales, marketing and service activities. To learn more about what entities mean in MS Dynamics, refer [here](https://learn.microsoft.com/en-us/dynamics365/customerengagement/on-premises/developer/introduction-entities?view=op-9-1).
  </Step>

  <Step>
    Under **Data Entity**, depending on the type of data you want to ingest, choose either **Customer Data** or **Non Customer Data** and proceed with the Source creation. To know more about Customer Data and Non Customer Data, refer [here](https://docs.zeotap.com/articles/unify-customer/supported-data-entities).

    <Frame>
      <img src="https://mintcdn.com/zeotap/ROPrHg77hrORMuiL/articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-16.png?fit=max&auto=format&n=ROPrHg77hrORMuiL&q=85&s=9dee349b57727b22dc9387afbe196206" width="3582" height="1782" data-path="articles/integrate-customer/Storage/integrate-customer/create-an-ms-dynamics-crm-source/create-an-ms-dynamics-crm-source-2024-09-19-16.png" />
    </Frame>
  </Step>

  <Step>
    Review the fields enter above and click **Create Source**. The created Microsoft Dynamics CRM source is listed on the source listing page. In the **IMPLEMENTATION DETAILS** tab of the source, you can find details about the source.
  </Step>
</Steps>

## What Next?

If you need further assistance or queries related to Microsoft Dynamics CRM source creation, reach out to your Zeotap POC.

## Related Topics

* For information about what is Customer Data and Non-Customer Entity data, refer [here](https://docs.zeotap.com/articles/unify-customer/supported-data-entities).
* For information about how to map the Catalogue for Customer Data (CE), refer [here](https://docs.zeotap.com/articles/unify-customer/map-the-catalogue-for-customer-data).
* For information about how to map the Catalogue for Non-Customer Entity Data (NCE), refer [here](https://docs.zeotap.com/articles/unify-customer/map-the-catalogue-for-non-customer-entity-data).