# Dotdigital API Preference API

**Canonical:** https://apis.io/apis/dotdigital/dotdigital-apipreference-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 Preference 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 ApiPreference. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The ApiPreference API from Dotdigital — 14 operation(s) for apipreference.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/preferences` | Gets the preferences, as a tree structure. |
| POST | `/v2/preferences` | Creates a new preference or a new preference category. |
| GET | `/v2/preferences/modified-since/{sinceDate}` | Gets an array of preferences that have been modified since the specified date. |
| PUT | `/v2/preferences/{id}` | Update the preference with the specified Id. |
| DELETE | `/v2/preferences/{id}` | Deletes the preference with the specified Id. |
| GET | `/v2/contacts/with-preference/{preferenceId}` | Gets a list of contacts subscribed to the specified preference. |
| GET | `/v2/address-books/{bookId}/contacts/with-preference/{preferenceId}` | Gets a list of contacts from a given list, subscribed to the specified preference. |
| PUT | `/v2/contacts/{contactId}/preferences` | Sets the subscribed preferences for a contact |
| PUT | `/v2/contact/{contactId}/preferences` | Sets the subscribed preferences for a contact |
| PUT | `/v2/contacts/{contactEmail}/preferences` | Sets the subscribed preferences for a contact |
| GET | `/v2/contacts/{contactEmail}/preferences` | Gets the preferences for the specified contact |
| PUT | `/v2/contact/{contactEmail}/preferences` | Sets the subscribed preferences for a contact |
| GET | `/v2/contact/{contactEmail}/preferences` | Gets the preferences for the specified contact |
| GET | `/v2/contacts/{contactID}/preferences` | Gets the preferences for the specified contact |
| GET | `/v2/contact/{contactID}/preferences` | Gets the preferences for the specified contact |
| GET | `/v2/contacts/{contactEmail}/subscriptions` | Gets the subscriptions for the specified contact |
| GET | `/v2/contacts/with-preference/{preferenceId}/opt-ins-since/{sinceDate}` | Gets a list of contacts who have opted in to a preference since the specified date |
| GET | `/v2/address-books/{bookId}/contacts/with-preference/{preferenceId}/opt-ins-since/{sinceDate}` | Gets a list of contacts, from a given list, who have opted in to a preference, since the specified date |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/dotdigital/refs/heads/main/openapi/dotdigital-apipreference-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 API](https://apis.io/apis/dotdigital/dotdigital-apicontact-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/)

## Tags

ApiPreference

---

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