Using Power Automate (Flow) to merge contacts

Using Power Automate (Flow) to merge contacts

When using Power Automate, there is no default method in the Common Data Service connector to merge accounts, contacts, leads or incidents. As you can see, there is only the ability to create, update or delete records.

That’s a bummer, cause sometimes you want to merge twee records. Luckily it’s possible! You just have to know how.

In the example I’ve got to merge two contacts. I assume you already know how to get the proper contact records, so I won’t go over that.

Since there is no method in the connector, we’ll have to build it ourselves. We’ll use the HTTP method on the HTTP connector.

Start the setup

To setup the HTTP call, let’s start with the basics. Give your action a proper name! Please don’t think lightly about naming actions, since it’s so important to do that right away. It organizes the whole flow so if anyone needs to change it afterwards, they still understand what it’s doing. I named my step ‘Merge Contacts’. Makes sense, right? 🙂

The most properties in the HTTP call are easy and fixed. Some of them need some more attention. Let’s first do the easy properties.

  • Method is always POST
  • URI is your CDS / CRM url with the addidion ‘/api/data/v9.1/Merge
  • For the Headers, we need two additional headers
    Accept | application/json
    Content-Type | application/json; charset=utf-8
  • You may leave the Queries empty
  • For the body, please start with this code
  "PerformParentingChecks": false,
  "Target": {
    "@@odata.type": "",
    "contactid": "00000000-0000-0000-0000-000000000000"
  "Subordinate": {
    "@@odata.type": "",
    "contactid": "00000000-0000-0000-0000-000000000000"
  "UpdateContent": {
    "@@odata.type": "",
    "contactid": "00000000-0000-0000-0000-000000000000"

Now let’s have a look at the body. There are two things you need to change at least. First on line 5, we have the ID of the contact that will be the target. We’ll merge both contacts to this one. Replace the 00000000-0000-0000-0000-000000000000 with the contact id. Look in your previous steps for Contact field with a description containing the Unique Identifier. The double quotes should still be around the Contact field. Second, you need to do the same with with your other Contact, but on line 9.

The only thing that is still to be done is the authentication. Since this is not a predefined connector, you’ll have to deal with the authentication yourself. Authenticating to CDS always works based upon Active Directory oAuth. The tenant is your domein (i.e., the Audience your CDS ul and the Credential Type can be set to Secret. The only two things that are left are the Client ID and Secret. You need to setup server-2-server authentication to get these two. If you want to know how? Check my other blog about authenticating with server-2-server authentication.

That’s it! You’re all set and can automate the merge of contact records in CDS.

8 Replies to “Using Power Automate (Flow) to merge contacts”

  1. There is no need to use http requests anymore after cds current environment adapter was released because it added support of calling of bound and unbound actions. Merge is the unbound one.

    1. Hi Andrew,

      They released this new feature 2 weeks after my blogpost. However, it still applies to the CDS connector. They only updated the CDS connector that is solution aware. If you use the default CDS connector outside a solution, this is the only way to merge.

  2. What should be the contact id for UpdateContent? Also, what does the Perform Parenting checks setting do?

    1. Hi Vivek,

      I’ve tried to figure out what that is for, but I couldn’t find the meaning of it. You can leave it blank as in my example and it just works.

  3. Hi! I wanted to understand, do all the child records follow and are now associated to this new master record?

    1. Hi,
      You can only select one child record at a time. So every time you to the merge action, one child record is associated with the master record.

  4. Hi

    How can we merge using unbound merge action? We have multiple duplicate leads coming into dynamics from different system and want to automatically merge them using Power automate. do you have any suggestions?

    1. Hi,
      You don’t need to use this solution anymore as the “Common Data Service (current environment)” does not support running unbound actions. You can simply call a Merge action from this connector.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.