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.

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