Submit a ticket

Getting started with Dynamics CRM

This article explains how to activate the integration between Oneflow and Dynamics.


You can only connect one Oneflow account to a specific Dynamics account. Subsequently, changing the Oneflow account connected to that Dynamics account will be impossible.

Enable Dynamics CRM integration extension

To enable the Dynamics integration:

  1. Login to Oneflow as an administrator. 
  2. In Oneflow, go to Admin  > Extensions and click on the Dynamics CRM extension. 
  3. Enable the extension by clicking on the toggle.
  4. A pop-up window will appear with an API token. Copy the token and securely save it for later use.
  5. Close the API token window and click the Dynamics CRM extension, then click on Go to AppSource.
  6. You will be redirected to the Microsoft AppSource page. Click on Get it now.
  7. You will be asked to provide profile info and give permissions to Microsoft. Click Continue. You will get redirected to the environment setup.
  8. Select an environment and click Install.
  9. Wait a few minutes until installation is finished.

Configure extension in Dynamics

Once the solution is installed:

  1. Go to your Dynamics environment and proceed to the Advanced Settings section.
  2. You should be able to see the Oneflow Settings section under the Settings.
  3. Click Settings > Oneflow Settings.
  4. You might see the following warning:
  5. You need to assign the Oneflow Admin security role to your user. You can always do this in your environment
  6. Under the Access section > Users, click See all.
  7. Click your user name.
  8. Under the Roles section, click Manage roles.
  9. The role you need to assign to your user is Oneflow Admin and Save.
  10. Once done, go back to the Oneflow settings page.

Set up the Oneflow application

Go through all the steps on the Settings page to complete the setup.

  1. Since we've already set up the integration, click Next.
  2. Create a Oneflow account (if you don't have one yet). You can do this by following this link -, then click Next when you're done.
  3. On the Authenticate Oneflow step, paste the API token you saved when you enabled the extension in Oneflow, then click Next.
  4. On the Authorize Dynamics from Oneflow step, go back to the Dynamics extension page in Oneflow.
  5. Enter your Dynamics organization URL into the Dynamics CRM instance URL box and click Authorize with Dynamics CRM.
    In the pop-up window, grant consent to the Oneflow application by clicking Accept.
  6. The Authorization with Dynamics CRM will be marked with a green checkmark when the authorization is successful.
  7. The step below is needed to set up real-time synchronization of contracts from Oneflow to your Dynamics organization.


    The user who grants consent should also be a global admin in your Microsoft organization.

    We use an Azure application to sync your contract data from Oneflow to your Dynamics instance. To do that, we're not impersonating a user who grants the permissions, but we create a separate app user in your Dynamics CRM that we will use to update contract data.


    To make this application work, a global admin user from your Microsoft tenant should grant application consent. Unfortunately, these are Microsoft's restrictions we can't avoid.

  8. Click Next.
  9. In the next step, you can assign the Oneflow user security role to the Dynamics users who will use the integration. Then click Next.
  10. Step 7: map your Account/contact fields to participants in Oneflow and click Finish.


    You already have a default mapping set up, but if you're using custom fields for any of the shown fields, you can specify them there.

That's it! Once you click on Finish, you should be done with setting up the extension on the Dynamics side.

Create a contract template

Create a contract template in Oneflow that you would like to use in Dynamics.

  1. In the contract template, specify the Template group as Dynamics CRM template and click Save.
  2. Go back to the template list and mark the template as Active.
    Now, you can go to a Dynamics opportunity and create a contract.

Create a contract in Dynamics

To create a contract:

  1. Open an opportunity you would like to create a contract for. 
  2. On the Oneflow widget, click the Create contract button.
  3. In the pop-up window, select the participants and click Create Contract.
  4. The contract preview information will appear in the widget. Click View contract to open it in Oneflow.

Notes and tips:

  • As a Oneflow administrator, take care to register the users with the same email address they use to log in to the Dynamics account.
  • If you want to remove the integration, you can disable it in Oneflow, delete the Oneflow solution from Dynamics and disable the Application user in your Dynamics instance.
  • When you authorize your dynamics instance in your account, the instance associated with your account cannot be changed. Please make sure to set up a test account in oneflow in case you want to test the integration before installing the solution to your production environment. 
  • If you've already associated an instance with your account and want to change it, please contact our support at .

Supported browsers

  • The latest version of Chrome

  • The latest version of Firefox

  • The latest version of Microsoft Edge.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.