# Dotdigital Lists / Address books API

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

The Lists / Address books API from Dotdigital — 14 operation(s) for lists / address books.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/address-books/{id}/campaigns` | Get campaigns sent to address book or segment |
| POST | `/v2/address-books` | Create list |
| GET | `/v2/address-books` | Get lists |
| DELETE | `/v2/address-books/{id}` | Delete list |
| PUT | `/v2/address-books/{id}` | Update list |
| GET | `/v2/address-books/{id}` | Get list |
| GET | `/v2/address-books/private` | Get private lists |
| GET | `/v2/address-books/public` | Get public lists |
| GET | `/v2/address-books/{id}/contacts/unsubscribed-since/{date}` | Get unsubscribed from list since date |
| POST | `/v2/address-books/{id}/contacts/unsubscribe` | Unsubscribe contact from list |
| POST | `/v2/address-books/{id}/contacts/resubscribe` | Resubscribe contact to list |
| POST | `/v2/address-books/{id}/contacts/resubscribe-with-no-challenge` | Resubscribe contact to list with no challenge |
| DELETE | `/v2/address-books/{addressBookId}/contacts/{contactId}` | Delete contact from list |
| POST | `/v2/address-books/{addressBookId}/contacts/delete` | Delete contacts from list |
| POST | `/v2/address-books/{addressBookId}/contacts/delete-all` | Delete all contacts from list |
| GET | `/v2/address-books/{addressBookId}/contacts/with-preference/{preferenceId}` | Get contacts opted into a preference and an address book |
| GET | `/v2/address-books/{addressBookId}/contacts/with-preference/{preferenceId}/opt-ins-since/{date}` | Get contacts with modified preference opt-in in address book since date |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/dotdigital/refs/heads/main/openapi/dotdigital-lists-address-books-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

Lists / Address books

---

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