Unified contacts


Public Preview

This service is in public preview.
This means that the API is ready to use, but it may be subject to change as we refine it.
We’d appreciate your feedback about your experience using the API to help us continue to improve it.

In order to use the new unified contacts functionality and APIs you must opt in to the public preview by following the instructions here. This change applies on an account level and cannot be reversed.

The new Dotdigital

Dotdigital has undergone a major evolution in the way you can work with and analyse your data. A huge part of this change is the introduction of unified contacts.

Understanding unified contacts

Dotdigital has offered the opportunity to engage with contacts using email and SMS for some time, however the contacts for each of these channels were isolated, preventing you from using the same address books and segments for both email and SMS communications. Unified contacts bring your data together so that a single contact can have multiple communication channel identifiers stored against it. A unified contact can be created with either an email address, mobile number or both.

How contacts have been merged into Unified Contacts

How contacts have been merged into unified contacts

How to reference a unified contact

When you create a contact in Dotdigital we pass back a unique, immutable contactId which you should retain in your system. This contactId is the most reliable way to refer to a contact, because it doesn’t change. This allows you to update any other identifiers associated with the contact.

In our new Unified Contacts compatible service we offer a flexible method of referencing a contact. You can refer to a contact using anyone of the following identifiers but you must specify which one you are using in the API call:

  • Contact ID
  • Email
  • Mobile number
Referencing a contact using an identifier type and value

Referencing a contact using an identifier type and value

What else has changed?

Address books are now lists

To align with wider industry terminology, and to reflect the greater variety of data you can store, address books have been renamed to lists. The functionality for lists is identical to the way you are used to working with address books. Any of your existing address books are automatically available as lists, with the same names and unique numeric ids.

Address books are referred to as lists with unified contacts

Address books are referred to as lists with unified contacts

A new-look UI

We’ve given the Dotdigital platform a fresh new look to more accurately reflect how your data and content, and our platform tools, are grouped and organised. When you opt in to the new Dotdigital, we’ll apply these changes for you.