# Microsoft Dynamics CRM Online

## Overview

The Microsoft Dynamics CRM Online Connector enables secure integration between Dynamics CRM Online and other systems using DBSync Cloud Workflow.

With this connector, you can move data into and out of your Dynamics CRM Online instance, enabling you to automate data synchronization and reduce manual data entry. Common uses include populating data warehouses, synchronizing customer master databases, streamlining transaction details, and managing online payments.

## Key Benefits

**For Business Users:**

* **Centralized CRM Data:** Keep customer, sales, and service records consistent across platforms.
* **Reduced Manual Effort:** Eliminate double data entry and accelerate business processes.
* **Improved Analytics:** Enable accurate reporting and downstream analytics by feeding CRM data into data warehouses or BI tools.

**For Technical Teams:**

* **Create, Read, and Update Data Operations:** Supports create, retrieve, and update operations on CRM entities.
* **Flexible Querying:** Allows use of native Fetch XML for advanced queries.
* **Event-Ready Sync:** Supports bi-directional and unidirectional workflows for flexible integration patterns.

## Prerequisites

Before configuring the connector, ensure the following:

1. **DBSync Access**
   * A valid license for this connector and access to the DBSync Cloud Workflow platform.
2. **Active user license for all apps requiring integration**
   * An active user license for all apps requiring integration, such as Sales, Customer and Service.
3. **Admin rights for D365**
   * Admin rights for your D365 Instance or a Global Admin with a D365 license.

## Connector Configuration

A connector instance represents a single Dynamics CRM Online account. To connect to multiple environments (for example, sandbox and production), create separate connector instances.

## Quick Setup Guide

{% stepper %}
{% step %}

### Login to DBSync Cloud Workflow

* Use your DBSync credentials to access the platform.
  {% endstep %}

{% step %}

### Add the Dynamics CRM Online Connector

* Navigate to the connectors list in the Apps pane and select Microsoft Dynamics CRM Online.
  {% endstep %}

{% step %}

### Enter CRM Credentials and Endpoint

* Enter the **username** and CRM Online **Endpoint** URL.
  {% endstep %}

{% step %}

### Configure Metadata Settings

* (Optional) Set **Meta Data Expand Depth** based on your requirement. By default, it is configured at *Expand 2 Level*. **Meta Data Expand Depth** controls the depth of related metadata retrieved during object discovery (for example, 1 or 2+).

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Meta Data Expand Depth:</strong> This option allows you to control how deeply related metadata is retrieved during object discovery.</p><ul><li><strong>Expand 1 Level:</strong> Retrieves only the immediate metadata of selected entities and their direct relationships.</li><li><strong>Expand 2 Level (default) or more:</strong> Includes nested relationships, which may be useful for more complex integrations but could impact performance.</li></ul><p><strong>Note:</strong> Choose a level based on your integration needs. A higher level may provide more context but may take longer to load metadata.</p> |
| {% endstep %}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

{% step %}

### Click Connect to Dynamics 365 CRM

Enter your login credentials (Username and password) to provide DBSync Dynamics 365 CRM connector access to authenticate and retrieve metadata.
{% endstep %}

{% step %}

### Test Connection

Click **Test Connector** to validate that the connector can authenticate and retrieve metadata.
{% endstep %}
{% endstepper %}

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FpptW1WBIaUNa69l5D12p%2Funknown.png?alt=media&#x26;token=f2b7da8a-e4d5-4a05-903b-06630f3dfc24" alt=""><figcaption></figcaption></figure>

## Uses

Once configured, this connector enables you to:

* **Export and Import CRM Data**
  * Transfer records to/from databases, applications, or storage systems.
* **Replicate Cloud Data**&#x20;
  * Build reporting, BI, or master data systems by replicating CRM data.
* **Integrate with ERP and SaaS Systems**&#x20;
  * Reduce manual entry by connecting CRM data with systems like QuickBooks, Intacct, and others.

## Configure Webhook Subscriptions for Your Automated Task

{% stepper %}
{% step %}

### Open the Automated Task page

Click the Automated Task for which you want to set up webhook triggers.
{% endstep %}

{% step %}

### Go to the Webhooks Tab

Click the **Webhooks** tab located at the top of the Flow Builder page (next to API, Forms, and others).
{% endstep %}

{% step %}

### Select the Connector

From the **Triggering App** dropdown, select *CRM Dynamics*.
{% endstep %}

{% step %}

### Choose the Objects

Check the boxes for the objects (for example, Customer, Invoice) that you want to monitor.
{% endstep %}

{% step %}

### Select Operations

For each selected object, choose the operations to trigger the webhook (for example, Create, Update, Delete).
{% endstep %}

{% step %}

### Click Subscribe

Once your selections are made, click **Subscribe** to activate webhook tracking.
{% endstep %}

{% step %}

### Test Your Workflow

Perform a test in your source system to confirm that the webhook triggers as expected in DBSync.
{% endstep %}
{% endstepper %}

Once done, DBSync will automatically push events directly from Dynamics CRM to the target system.

## Frequently Asked Questions (FAQ)

<details>

<summary>What versions are supported?</summary>

This connector supports Dynamics CRM Online 2011 and later versions.

</details>

<details>

<summary>Can I sync data both ways?</summary>

Yes, the connector supports both bi-directional and unidirectional data synchronization.

</details>

<details>

<summary>Can I perform custom mappings?</summary>

Yes, DBSync fully supports custom field mappings between CRM entities and target systems.

</details>

<details>

<summary>Does the connector support Fetch XML?</summary>

Yes, you can use native Fetch XML for advanced querying of CRM data.

</details>

<details>

<summary>What operations can be performed using this connector?</summary>

Perform create, retrieve, and update operations on all CRM entities, and use native Fetch XML for queries.

</details>

<details>

<summary>Can I schedule syncs?</summary>

Yes, DBSync allows scheduled workflows to automate recurring data syncs.

</details>

<details>

<summary>How do I handle errors?</summary>

DBSync provides execution logs, detailed error messages, and optional email notifications to help troubleshoot sync issues.

</details>

## Summary

The Microsoft Dynamics CRM Online Connector in DBSync Cloud Workflow provides a reliable, flexible way to integrate CRM data with other systems. With support for create, read, and update operations, structured metadata discovery, webhook-enabled near real-time sync, and deep customization, it enables business and technical teams to automate CRM data flows with confidence.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mydbsync.com/cloud-workflow/2026_connectors_new/microsoft-dynamics-crm-online.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
