# Dotdigital API Contact API

**Canonical:** https://apis.io/apis/dotdigital/dotdigital-apicontact-api/  
**Provider:** Dotdigital — https://apis.io/providers/dotdigital/  
**Base URL:** https://r1-api.dotdigital.com/v2  
**Documentation:** https://marketing.developer.dotdigital.com/docs/getting-started-with-the-api

Dotdigital API Contact API is one of 63 APIs that [Dotdigital](https://apis.io/providers/dotdigital/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include ApiContact. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The ApiContact API from Dotdigital — 43 operation(s) for apicontact.

## Operations (54)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/contacts/suppressed-since/{date}` | Gets a list of suppressed contacts after a given date along with the reason for suppression. |
| GET | `/v2/contacts/unsubscribed-since/{date}` | Gets a list of unsubscribed contacts who unsubscribed after a given date. |
| GET | `/v2/contacts/modified-since/{date}` | Gets a list of modified contacts after a specified date. |
| GET | `/v2/contacts/created-since/{date}` | Gets a list of created contacts after a specified date. |
| GET | `/v2/contacts` | Gets a list of all contacts in the account. |
| POST | `/v2/contacts` | Creates a contact. |
| GET | `/v2/contacts/{id}` | Gets a contact by ID. Unsubscribed or suppressed contacts will not be retrieved. |
| PUT | `/v2/contacts/{id}` | Updates a contact. |
| DELETE | `/v2/contacts/{id}` | Deletes a contact. |
| GET | `/v2/contacts/{id}/with-consent` | Gets a contact by ID with consent records. |
| PUT | `/v2/contacts/{id}/with-consent` | Updates a contact with consent records. |
| GET | `/v2/contacts/{email}` | Gets a contact by email address. |
| GET | `/v2/contacts/{email}/with-consent` | Gets a contact by email address with consent records. |
| POST | `/v2/contacts/with-consent` | Creates a contact with consent records. |
| POST | `/v2/contacts/with-consent-and-preferences` | Creates a contact with consent and preference records. |
| PUT | `/v2/contacts/{id}/with-consent-and-preferences` | Updates a contact with consent and preference records. |
| DELETE | `/v2/address-books/{addressBookId}/contacts/{contactId}` | Deletes a contact from a given list. |
| DELETE | `/v2/address-books/{addressBookId}/contacts` | Deletes all contacts from a given list. |
| GET | `/v2/address-books/{addressBookId}/contacts` | Gets a list of contacts in a given list. |
| POST | `/v2/address-books/{addressBookId}/contacts` | Adds a contact to a given list. |
| POST | `/v2/address-books/{addressBookId}/contacts/delete-all` | Deletes all contacts from a given list. |
| POST | `/v2/address-books/{addressBookId}/contacts/delete` | Deletes multiple contacts from a list. This will run in the background, and for larger lists may take some minutes to fully delete. |
| GET | `/v2/contacts/deletion/{deletionRequestId}` | Gets the status of a previously started request to delete contacts from a list. |
| GET | `/v2/address-books/{addressBookId}/contacts/modified-since/{date}` | Gets a list of contacts who were modified since a given date, in a given list. |
| GET | `/v2/address-books/{addressBookId}/contacts/unsubscribed-since/{date}` | Gets a list of contacts who have unsubscribed from a given list. |
| POST | `/v2/contacts/unsubscribe` | Unsubscribes contact from account. |
| PUT | `/v2/contacts/suppress-contacts` | Suppresses a batch of contacts from account. |
| POST | `/v2/address-books/{addressBookId}/contacts/unsubscribe` | Unsubscribes contact from a given list. |
| POST | `/v2/contacts/resubscribe` | Resubscribes a previously unsubscribed contact. |
| POST | `/v2/contacts/resubscribe-with-no-challenge` | Resubscribes a previously unsubscribed contact with no challenge. |
| POST | `/v2/address-books/{addressBookId}/contacts/resubscribe` | Resubscribes a previously unsubscribed contact to a given list. |
| POST | `/v2/address-books/{addressBookId}/contacts/resubscribe-with-no-challenge` | Resubscribes a previously unsubscribed contact to a given list with no challenge. |
| POST | `/v2/contacts/transactional-data/{collectionName}` | Adds a single piece of transactional data to a contact. |
| GET | `/v2/contacts/transactional-data/{collectionName}` | — |
| POST | `/v2/contacts/transactional-data/import/{collectionName}` | Adds multiple pieces of transactional data to contacts asynchronously, returning an identifier that can be used to check for import progress. |
| GET | `/v2/contacts/transactional-data/import/{importId}` | Gets the import status of a previously started transactional import. |
| GET | `/v2/contacts/transactional-data/import/{importId}/report` | Gets a report with statistics about what was successfully imported, and what was unable to be imported. |
| POST | `/v2/contacts/transactional-data/{collectionName}/{key}` | Replaces a piece of transactional data by key (logicall equivalent to a delete and an insert). |
| DELETE | `/v2/contacts/transactional-data/{collectionName}/{key}` | Deletes a piece of transactional data by key. |
| GET | `/v2/contacts/transactional-data/{collectionName}/{key}` | Gets a piece of transactional data by key. |
| PUT | `/v2/contacts/transactional-data/{collectionName}/empty` | Removes all items from a transactional data collection. |
| DELETE | `/v2/contacts/{id}/transactional-data/{collectionName}` | Deletes all transactional data for a contact. |
| GET | `/v2/contacts/{id}/transactional-data/{collectionName}` | Gets a list of all transactional data for a contact (100 most recent only). |
| DELETE | `/v2/contacts/{email}/transactional-data/{collectionName}` | Deletes all transactional data for a contact. |
| GET | `/v2/contacts/{email}/transactional-data/{collectionName}` | Gets a list of all transactional data for a contact (100 most recent only). |
| GET | `/v2/transactional-data/{collectionName}` | Gets a list of account scoped transactional data for given collection |
| GET | `/v2/contacts/transactional-data-collections` | Gets a list of transactional data collections. |
| GET | `/v2/contacts/score` | Gets a list of contact scoring data. |
| GET | `/v2/address-books/{addressBookId}/contacts/score` | Gets a list of contact scoring data in specified list. |
| GET | `/v2/contacts/score/modified-since/{date}` | Gets a list of contact scoring data ordered by modified date. |
| GET | `/v2/contacts/{email}/score` | Gets particular contact scoring data. |
| GET | `/v2/contacts/{id}/score` | Gets particular contact scoring data. |
| GET | `/v2/contacts/count` | Gets the total number of contacts in an account. |
| GET | `/v2/contacts/retrieve-collection` | Gets a batch of contacts by ID or email address. |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/dotdigital/refs/heads/main/openapi/dotdigital-apicontact-api-openapi.yml
- **Documentation** — https://marketing.developer.dotdigital.com/docs/getting-started-with-the-api
- **APIReference** — https://marketing.developer.dotdigital.com/reference/
- **Documentation** — https://marketing.developer.dotdigital.com/docs/api-end-points
- **APIReference** — https://marketing.developer.dotdigital.com/reference/unified-contacts
- **Documentation** — https://marketing.developer.dotdigital.com/reference/omnichannel-api

## Other Dotdigital APIs (12)

- [Dotdigital Marketing Developer Hub MCP Server](https://apis.io/apis/dotdigital/dotdigital-marketing-developer-hub-mcp-server/)
- [Dotdigital Accounts and Utilities API](https://apis.io/apis/dotdigital/dotdigital-accounts-and-utilities-api/)
- [Dotdigital API Account API](https://apis.io/apis/dotdigital/dotdigital-apiaccount-api/)
- [Dotdigital API Address Book API](https://apis.io/apis/dotdigital/dotdigital-apiaddressbook-api/)
- [Dotdigital API Campaign API](https://apis.io/apis/dotdigital/dotdigital-apicampaign-api/)
- [Dotdigital API Campaign From Address API](https://apis.io/apis/dotdigital/dotdigital-apicampaignfromaddress-api/)
- [Dotdigital API Campaign Reporting API](https://apis.io/apis/dotdigital/dotdigital-apicampaignreporting-api/)
- [Dotdigital API Campaign Send API](https://apis.io/apis/dotdigital/dotdigital-apicampaignsend-api/)
- [Dotdigital API Contact Import API](https://apis.io/apis/dotdigital/dotdigital-apicontactimport-api/)
- [Dotdigital API Data Field API](https://apis.io/apis/dotdigital/dotdigital-apidatafield-api/)
- [Dotdigital API Document API](https://apis.io/apis/dotdigital/dotdigital-apidocument-api/)
- [Dotdigital API Ecommerce API](https://apis.io/apis/dotdigital/dotdigital-apiecommerce-api/)

## Tags

ApiContact

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/dotdigital/dotdigital-apicontact-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/dotdigital/.