---
updatedAt: 2026-06-24T16:30:28.000Z
agentTools:
  projectIndex: https://marketing.developer.dotdigital.com/llms.txt
---

# Contacts

# Understanding  contacts   &#x20;

A contact record can have multiple communication channel identifiers stored against it, as well as any other data you need to store. A contact can be created with either an email address, or a mobile number, or both.

<Image src="https://files.readme.io/dcbc923623cb8010dbb4d34d4a40b96838e1f104fd8e191bbc3fef0ffec832c8-Unified_contacts_Diagram-Unified_contact.webp" alt="How contacts have been merged into Unified Contacts" align="center" />

# How to reference a contact

When you create a contact in Dotdigital Marketing, 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.

Our contacts service offers 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 to match on:

* Contact ID
* Email
* Mobile number ( In international format [E.164](https://en.wikipedia.org/wiki/E.164) )
* [Custom identifiers](https://marketing.developer.dotdigital.com/reference/custom-identifiers)

<Image src="https://files.readme.io/f714abe2f749cdfd4e69fe47b4ce12b026e2e004ec58e8c05ca423a024e03998-uc-1.png" alt="Referencing a contact using an identifier type and value" align="center" width="500px" caption="Referencing a contact using an identifier type and value" />

# Channel subscription behavior

Dotdigital Marketing is designed for CXDP functionality and therefore allows the updating of contact data independent of any channels status, as no assumptions are made on how or why you are storing the contacts data.

This means that we do allow a contact's data fields to be updated even where they are suppressed, without the necessity of changing the contact's channel status(es) - we don't reject any updates because they are suppressed. Updating a suppressed contact will succeed and the contacts channel statuses will remain unchanged unless otherwise stated in the update.

**Note:**

* When you add a phone number, at least one mobile channel must have a different value than `noSubscription`.

## How to update a channel subscription status

Our contacts API's support updating a contacts subscription for one or more channels in the various update calls via the `channelProperties` field. We recommend using [Import contact collection](https://marketing.developer.dotdigital.com/reference/importcontacts-1) for bulk updates and [Import a single contact](https://marketing.developer.dotdigital.com/reference/importcontact) for individual updates.

# Using lists with contacts

## Adding contacts to lists

You need to use the [Contacts API](https://marketing.developer.dotdigital.com/reference/unified-contacts) to add contacts to lists; we recommend using [Import a single contact](https://marketing.developer.dotdigital.com/reference/importcontact) for individual updates and [Import contact collection](https://marketing.developer.dotdigital.com/reference/importcontacts-1) for bulk operations. The `lists` field can be used to specify up to 100 list IDs to add a contact to.

## Finding contacts in lists and segments

We recommend that you use the [Contacts API](https://marketing.developer.dotdigital.com/reference/unified-contacts)  for interacting with any contacts. You should use the [Get contacts based on your criteria](https://marketing.developer.dotdigital.com/reference/getcontacts-1) call with the `~listId` filter to find contacts in a list, and the `~segmentId` can be used for segments.

### Finding modified contacts in a list or segment

We recommend using the [Get contacts based on your criteria](https://marketing.developer.dotdigital.com/reference/getcontacts-1) with the `~modified` filter used in conjunction with either the `~listId` filter or the `~segmentId`  to find contacts modified after a specific date-time in a list or segment.

# Contact deletion

In order to afford customers the opportunity to restore contacts that they have been engaging with, we run a staged removal of contact data and their related data.

## Deletion stage 1 - Soft delete and binned

Whenever  a contact is deleted in app or via API the contact in put into the [recycle bin](https://support.dotdigital.com/en/articles/8199445-use-the-recycle-bin)  and the contact status is updated to `binned`.

The handling of binned contacts differs depending on the contacts channel subscription status:

* Contacts subscribed to at least one channel are stored in the [recycle bin](https://support.dotdigital.com/en/articles/8199445-use-the-recycle-bin) for up to 30 days at which point they move to [deletion stage 2](#deletion-stage-2---hard-delete-and-anonymization)  to be hard deleted and anonymized.
* Suppressed contacts, with no subscriptions on any channel, immediately move to [deletion stage 2](#deletion-stage-2---hard-delete-and-anonymization) to be hard deleted and anonymized. &#x20;

> 🚧 Emptying the recycle bin
>
> If the recycle bin is emptied in app or via API using [Empty recycle bin call](https://marketing.developer.dotdigital.com/reference/empty-recycle-bin) then all binned contacts immediately proceed to [deletion stage 2](#deletion-stage-2---hard-delete-and-anonymization) for hard deletion and anonymization. &#x20;

## Deletion stage 2 - Hard delete and anonymization

At this stage a contact is hard deleted and any data we cannot delete is anonymized.

Data that is hard deleted includes:

* all data on the contact's record
* data fields
* channel data
* all contact-scoped insight data

*We retain any suppressed/unsubscribed channel identifiers to ensure that the unsubscribe is retained.*

The contact's channel identifiers and engagement statistics are anonymized.

> ❗️ Hard deleted contacts cannot be recovered
>
> Once contacts have left the recycle bin and proceeded to be hard deleted and anonymized they cannot be recovered.

## Contact restoration

If a contact is in the [recycle bin](https://support.dotdigital.com/en/articles/8199445-use-the-recycle-bin) (status `binned`) they can be [restored in app manually](https://support.dotdigital.com/en/articles/8199445-use-the-recycle-bin#h_dc2340f7e5) or if you import via API a contact with at least one identifier with the same value as a binned contact.

# Syncing contact changes

The [Events API](https://marketing.developer.dotdigital.com/reference/export-events) is the recommended way to establish a high throughput, low latency data synchronisation from Dotdigital Marketing to your platforms and systems.

The [Events API](https://marketing.developer.dotdigital.com/reference/export-events) removes the need to integrate to a multitude of APIs to sync any data changes you're interested in. Instead, just subscribe to the events you're interested in, and sync as often as you need.

Events cover a vast array of activity within Dotdigital Marketing, including:

* Changes to contacts
  * Additions, deletions, or updates
  * List membership updated
  * Segment membership updated
  * Changes to preferences
  * Changes to marketing consent

* Messaging activity across all our supported channels:
  * Message sent
  * Message received
  * Message status updates

* Interactions
  * Link clicks
  * Push messages tapped
  * Social shares of your content
  * Unsubscribes - attribute unsubscribes back to the campaign that triggered it

* Insight data changes
  * Additions, deletions, and updates
  * Collection changes

<br />

# Sub pages

* [Get contacts based on your criteria](https://marketing.developer.dotdigital.com/reference/getcontacts-1.md)
* [Import contact collection](https://marketing.developer.dotdigital.com/reference/importcontacts-1.md)
* [Get the status of a contacts import request](https://marketing.developer.dotdigital.com/reference/getimportstatus.md)
* [Get a contact by an identifier](https://marketing.developer.dotdigital.com/reference/getcontact.md)
* [Get the status of a delete contacts job](https://marketing.developer.dotdigital.com/reference/getdeletestatus.md)
* [Delete multiple contacts](https://marketing.developer.dotdigital.com/reference/deletecontacts.md)
* [Create a contact](https://marketing.developer.dotdigital.com/reference/createcontact-1.md)
* [Replace a contact](https://marketing.developer.dotdigital.com/reference/replacecontact.md)
* [Deletes a contact using a specific identifier](https://marketing.developer.dotdigital.com/reference/deletecontact-1.md)
* [Import a single contact](https://marketing.developer.dotdigital.com/reference/importcontact.md)

# Sibling pages

* [Custom identifiers](https://marketing.developer.dotdigital.com/reference/custom-identifiers.md)
* [Contact data fields](https://marketing.developer.dotdigital.com/reference/contact-data-fields.md)
* [Lists / Address books](https://marketing.developer.dotdigital.com/reference/address-books.md)
* [Preferences and subscriptions](https://marketing.developer.dotdigital.com/reference/preferences.md)
* [Segments](https://marketing.developer.dotdigital.com/reference/segments.md)
* [Scoring](https://marketing.developer.dotdigital.com/reference/scoring.md)

# What’s Next

Check out the Unified Contacts API calls

* [Get contacts based on your criteria](https://marketing.developer.dotdigital.com/reference/getcontacts-1.md)