This article covers integrating GeckoChat with Microsoft Dynamics. Users looking to integrate GeckoEngage with Dynamics should click here

Integrating GeckoChat allows you to send contact data into your Dynamics account and populate your contacts and lead module fields.

Once you have completed the setup, you are able to go into your Custom Contact fields in GeckoChat (Settings > Contact Fields) and pick the information you would like to collect before it triggers a sync. For example, you are able to create a setup whereby you would need to first collect the students' name, email, course of interest and nationality before sending any data across.

The below setup provides a set by step guide on how to setup your Dynamics integration. Once this is done - you would be able to setup your field mappings and start sending data across automatically!


  1. Obtain your Dynamics instance URL.

    2. Register GeckoChat as an authorised app for your Dynamics account.

  • Select Azure Active Directory from the left-hand menu bar (this will make the directory 'blade' appear).

  • Select App Registrations from the first column of options.

  • Select + New registration

  • Fill out the form that will appear with the 'Name' = 'GeckoChat', then click the 'Register' button

  • You will then be presented with the GeckoChat registered app window. Make sure to make a note of your Application (client) ID (This is your App ID).

  • Click on the 'Add a Redirect URI' link

US -
EU -

  • Select Save.

  • Select API Permissions from the same menu and click +Add a Permission on the new 'blade' that appears.

  • This will open a new section to the right, select Select an API and then pick Dynamics CRM from the list that appears.

  • From the new section that appears, click on the checkbox for 'user_impersonation' and then click on the 'Add permissions' button

  • Now select 'Certificates and secrets'. From the new section that appears, click on the '+ New client secret' button

  • Create a new Client secret by entering 'GeckoChatKey' in the 'Description' field and select the 'Never' option in the 'Expires' section

  • Click the Add button and you should see the secret 'Value' - a string of random numbers and characters - as shown. Make sure you make a note of this (this is your Password Key).

3. Setup the integration in GeckoChat.

Now that you have your: 

  • Dynamics Instance URL.

  • App ID.

  • Password Key.

(You should have taken note of those as you followed the above instructions)

  • Login to GeckoChat.

  • Navigate to Settings > Integrations

  • Select Setup for the dynamics integration.

  • Fill out the above credentials.

  • Select Done.

  • You will be redirected to an Azure Dynamics page to grant permission to GeckoChat, select Accept.

This is your integration now setup!

    4. Mapping fields

Now that the integration is setup, you will be taken to your MS Dynamics integration page, where you are able to setup the different fields you would like to send information to. 

  • Click on the Add New button.

  • Select the Module of the field you would like to integrate with.

  • Pick the specific field.

  • Select to either create a new field in GeckoChat or map to an existing one. 

  • (Based on your above option) select either the GeckoChat field or pick the type of new field you would like to create.

  • Select Save.

Repeat this for each field you would like to populate in Dynamics and you are done!

Any questions? Feel free to start a live chat with a member of our support team or explore the rest of our academy at your leisure.

Did this answer your question?