Dotdigital

Dotdigital Lists / Address books API

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

GitHub OpenAPI

Operations 17

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 #

Documentation

📖
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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dotdigital/refs/heads/main/openapi/dotdigital-lists-address-books-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dotdigital-lists-address-books-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dotdigital-lists-address-books-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Lists / Address books API
  version: 2.0.2
  description: 'Manage contact lists (address books) and their memberships. Use this API to create, update, and delete lists; retrieve all, public, or private lists; bulk-import contacts; remove individual or multiple contacts; manage subscription status (unsubscribe and resubscribe); and query contacts within a list by preference opt-in status or unsubscribe date.

    '
servers:
- url: https://{region}-api.dotdigital.com
  variables:
    region:
      default: r1
      enum:
      - r1
      - r2
      - r3
      description: The Dotdigital region id your account belongs to
security:
- basicAuth: []
tags:
- name: Lists / Address books
paths:
  /v2/address-books/{id}/campaigns:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    get:
      summary: Get campaigns sent to address book or segment
      deprecated: false
      description: Gets any campaigns that have been sent to an address book or a segment
      operationId: get-campaigns-sent-to-address-book-or-segment
      tags:
      - Lists / Address books
      parameters:
      - name: id
        in: path
        description: The ID of the address book or segment
        required: true
        example: 0
        schema:
          type: integer
          format: int32
      - name: select
        in: query
        description: he select parameter requires a number between 1 and 1000 (0 is not a valid number). You may only select a maximum of 1000 results in a single request. This parameter goes within the URL.
        required: false
        schema:
          type: integer
          format: int32
      - name: skip
        in: query
        description: The skip parameter should be used in tandem with the select parameter when wanting to iterate through a whole data set. If you want to select the next 1000 records you should set the select parameter to 1000 and the skip parameter to 1000, which will return records 1001 to 2000. You should continue to do this until 0 records are returned to retrieve the whole data set.
        required: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      default: 0
                      examples:
                      - 1
                    name:
                      type: string
                      examples:
                      - Monthly newsletter Dec 2015
                    subject:
                      type: string
                      examples:
                      - Monthly newsletter
                    fromName:
                      type: string
                      examples:
                      - Company name
                    fromAddress:
                      type: object
                      properties:
                        id:
                          type: integer
                          default: 0
                          examples:
                          - 1
                        email:
                          type: string
                          examples:
                          - demo@apiconnector.com
                    htmlContent: {}
                    plainTextContent: {}
                    replyAction:
                      type: string
                      examples:
                      - Unset
                    replyToAddress: {}
                    isSplitTest:
                      type: boolean
                      default: true
                      examples:
                      - false
                    status:
                      type: string
                      examples:
                      - Sent
              examples:
                Result:
                  summary: Result
                  value:
                  - id: 1
                    name: Monthly newsletter Dec 2015
                    subject: Monthly newsletter
                    fromName: Company name
                    fromAddress:
                      id: 1
                      email: demo@apiconnector.com
                    htmlContent: null
                    plainTextContent: null
                    replyAction: Unset
                    replyToAddress: null
                    isSplitTest: false
                    status: Sent
                  - id: 4
                    name: New product promotion
                    subject: New product!
                    fromName: Company name
                    fromAddress:
                      id: 1
                      email: demo@apiconnector.com
                    htmlContent: null
                    plainTextContent: null
                    replyAction: WebMailForward
                    replyToAddress: demo@apiconnector.com
                    isSplitTest: false
                    status: Sent
  /v2/address-books:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    post:
      summary: Create list
      deprecated: false
      description: Creates an list / address book
      operationId: create-address-book
      tags:
      - Lists / Address books
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                  description: The name of the address book. (max 128 characters)
                  maxLength: 128
                visibility:
                  type: string
                  description: All address books are created as 'Private' by default but you can set it as 'Public' upon creation should you wish to.
                  default: Private
                  enum:
                  - Private
                  - Public
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    default: 0
                    examples:
                    - 1
                  name:
                    type: string
                    examples:
                    - My Address Book
                  visibility:
                    type: string
                    examples:
                    - Public
                  contacts:
                    type: integer
                    default: 0
                    examples:
                    - 0
              examples:
                Result:
                  summary: Result
                  value:
                    id: 1
                    name: My Address Book
                    visibility: Public
                    contacts: 0
    get:
      summary: Get lists
      deprecated: false
      description: Gets all lists / address books
      operationId: get-address-books
      tags:
      - Lists / Address books
      parameters:
      - name: select
        in: query
        description: The number of records to select between 1 and 1000
        required: false
        schema:
          type: integer
          format: int32
      - name: skip
        in: query
        description: The numbers of records to skip in the result set
        required: false
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      default: 0
                      examples:
                      - 1
                    name:
                      type: string
                      examples:
                      - Address book 1
                    visibility:
                      type: string
                      examples:
                      - Private
                    contacts:
                      type: integer
                      default: 0
                      examples:
                      - 5
              examples:
                Result:
                  summary: Result
                  value:
                  - id: 1
                    name: Address book 1
                    visibility: Private
                    contacts: 5
                  - id: 2
                    name: Address book 2
                    visibility: Public
                    contacts: 7
                  - id: 3
                    name: Address book 3
                    visibility: Private
                    contacts: 7
                  - id: 4
                    name: Address book 4
                    visibility: Public
                    contacts: 6
  /v2/address-books/{id}:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    delete:
      summary: Delete list
      deprecated: false
      description: Deletes an list / address book by id
      operationId: delete-address-book
      tags:
      - Lists / Address books
      parameters:
      - name: id
        in: path
        description: The ID of the list / address book
        required: true
        example: 0
        schema:
          type: integer
          format: int32
      responses:
        '204':
          description: '204'
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                Result:
                  summary: Result
                  value: {}
    put:
      summary: Update list
      deprecated: false
      description: Updates an list / address book by id
      operationId: update-address-book
      tags:
      - Lists / Address books
      parameters:
      - name: id
        in: path
        description: The ID of the address book
        required: true
        example: 0
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                  description: The name of the address book. (max 128 characters)
                visibility:
                  type: string
                  description: All address books are created as 'Private' by default but you can set it as 'Public' upon creation should you wish to.
                  default: Private
                  enum:
                  - Private
                  - Public
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    default: 0
                    examples:
                    - 1
                  name:
                    type: string
                    examples:
                    - My Updated Address Book
                  visibility:
                    type: string
                    examples:
                    - Private
                  contacts:
                    type: integer
                    default: 0
                    examples:
                    - 0
              examples:
                Result:
                  summary: Result
                  value:
                    id: 1
                    name: My Updated Address Book
                    visibility: Private
                    contacts: 0
    get:
      summary: Get list
      deprecated: false
      description: This operation retrieves an list / address book by its id
      operationId: get-address-book
      tags:
      - Lists / Address books
      parameters:
      - name: id
        in: path
        description: The ID of the list / address book
        required: true
        example: 0
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    default: 0
                    examples:
                    - 2
                  name:
                    type: string
                    examples:
                    - Address book 2
                  visibility:
                    type: string
                    examples:
                    - Private
                  contacts:
                    type: integer
                    default: 0
                    examples:
                    - 5
              examples:
                Result:
                  summary: Result
                  value:
                    id: 2
                    name: Address book 2
                    visibility: Private
                    contacts: 5
  /v2/address-books/private:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    get:
      summary: Get private lists
      deprecated: false
      description: Gets all private lists / address books
      operationId: get-private-address-books
      tags:
      - Lists / Address books
      parameters:
      - name: limit
        in: query
        description: The number of records to select between 1 and 1000
        required: false
        schema:
          type: integer
          format: int32
      - name: skip
        in: query
        description: The numbers of records to skip in the result set
        required: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      default: 0
                      examples:
                      - 2
                    name:
                      type: string
                      examples:
                      - Address book 2
                    visibility:
                      type: string
                      examples:
                      - Private
                    contacts:
                      type: integer
                      default: 0
                      examples:
                      - 5
              examples:
                Result:
                  summary: Result
                  value:
                  - id: 2
                    name: Address book 2
                    visibility: Private
                    contacts: 5
                  - id: 3
                    name: Address book 3
                    visibility: Private
                    contacts: 7
  /v2/address-books/public:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    get:
      summary: Get public lists
      deprecated: false
      description: Gets all public lists / address books
      operationId: get-public-address-books
      tags:
      - Lists / Address books
      parameters:
      - name: select
        in: query
        description: The number of records to select between 1 and 1000
        required: false
        schema:
          type: integer
          format: int32
      - name: skip
        in: query
        description: The numbers of records to skip in the result set
        required: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      default: 0
                      examples:
                      - 2
                    name:
                      type: string
                      examples:
                      - Address book 2
                    visibility:
                      type: string
                      examples:
                      - Private
                    contacts:
                      type: integer
                      default: 0
                      examples:
                      - 5
              examples:
                Result:
                  summary: Result
                  value:
                  - id: 2
                    name: Address book 2
                    visibility: Private
                    contacts: 5
                  - id: 3
                    name: Address book 3
                    visibility: Private
                    contacts: 7
  /v2/address-books/{id}/contacts/unsubscribed-since/{date}:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    get:
      summary: Get unsubscribed from list since date
      deprecated: false
      description: Gets a list of contacts who have unsubscribed since a given date from a given list / address book
      operationId: get-unsubscribed-contacts-from-address-book-since-date
      tags:
      - Lists / Address books
      parameters:
      - name: id
        in: path
        description: The id of the list / address book
        required: true
        example: 0
        schema:
          type: integer
          format: int32
      - name: date
        in: path
        description: The date from which any unsubscribed contacts are returned in [ISO 8601 format](https://www.w3.org/TR/xmlschema-2/#dateTime)
        required: true
        example: ''
        schema:
          type: string
          format: date
      - name: select
        in: query
        description: The number of records to select between 1 and 1000
        required: false
        schema:
          type: integer
          format: int32
      - name: skip
        in: query
        description: The numbers of records to skip in the result set
        required: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                Result:
                  summary: Result
                  value: '[

                    {

                    "suppressedContact": {

                    "id": 1,

                    "email": "nelson.redeker@example.com",

                    "optInType": "Unknown",

                    "emailType": "PlainText",

                    "dataFields": null,

                    "status": "Unsubscribed"

                    },

                    "dateRemoved": "2020-01-01T09:40:18.527Z",

                    "reason": "Unsubscribed"

                    },

                    {

                    "suppressedContact": {

                    "id": 25,

                    "email": "terry.mccarthy@example.com",

                    "optInType": "VerifiedDouble",

                    "emailType": "Html",

                    "dataFields": null,

                    "status": "Unsubscribed"

                    },

                    "dateRemoved": "2020-01-01T09:40:18.527Z",

                    "reason": "Unsubscribed"

                    },

                    ]'
  /v2/address-books/{id}/contacts/unsubscribe:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    post:
      summary: Unsubscribe contact from list
      deprecated: false
      description: Unsubscribes contact from a given list / address book
      operationId: unsubscribe-contact-from-address-book
      tags:
      - Lists / Address books
      parameters:
      - name: id
        in: path
        description: The id of the list / address book
        required: true
        example: 0
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              properties:
                email:
                  type: string
                  description: The email address of the contact to be unsubscribed
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  suppressedContact:
                    type: object
                    properties:
                      id:
                        type: integer
                        default: 0
                        examples:
                        - 123456
                      email:
                        type: string
                        examples:
                        - example@emailsim.io
                      optInType:
                        type: string
                        examples:
                        - Unknown
                      emailType:
                        type: string
                        examples:
                        - Html
                      dataFields: {}
                      status:
                        type: string
                        examples:
                        - Subscribed
                  dateRemoved:
                    type: string
                    examples:
                    - '2025-07-23 11:01:55.433000+00:00'
                  reason:
                    type: string
                    examples:
                    - Unsubscribed
              examples:
                Result:
                  summary: Result
                  value:
                    suppressedContact:
                      id: 123456
                      email: example@emailsim.io
                      optInType: Unknown
                      emailType: Html
                      dataFields: null
                      status: Subscribed
                    dateRemoved: '2025-07-23 11:01:55.433000+00:00'
                    reason: Unsubscribed
  /v2/address-books/{id}/contacts/resubscribe:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    post:
      summary: Resubscribe contact to list
      deprecated: false
      description: Resubscribes a previously unsubscribed contact to a given list / address book
      operationId: resubscribe-contact-to-address-book
      tags:
      - Lists / Address books
      parameters:
      - name: id
        in: path
        description: The id of the list / address book
        required: true
        example: 0
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - unsubscribedContact
              properties:
                unsubscribedContact:
                  type: object
                  description: The details of the contact to be resubscribed
                  required:
                  - email
                  properties:
                    email:
                      type: string
                      description: The email address of the contact
                    dataFields:
                      type: array
                      description: The data fields for the contact
                      items:
                        properties:
                          key:
                            type: string
                            description: The key name
                          value:
                            type: string
                            description: The value associated with the key
                        required:
                        - key
                        - value
                        type: object
                preferredLocale:
                  type: string
                  description: The language code for the language you would like the resubscribe request email to be sent to the contact in
                  enum:
                  - cs-CS
                  - da-DA
                  - de-DE
                  - el-EL
                  - en-EN
                  - es-ES
                  - es
                  - fi-FI
                  - fr-FR
                  - hu-HU
                  - it-IT
                  - nl-NL
                  - nb-NO
                  - pl-PL
                  - pt-PT
                  - ru-RU
                  - se-SE
                  - sk-SK
                  - tr-TR
                  - zh-CN
                returnUrlToUseIfChallenged:
                  type: string
                  description: The URL you would like to redirect challenged contacts to after they have completed their resubscription
            examples:
              Request Example:
                value:
                  unsubscribedContact:
                    email: john.smith@emailsim.io
                    dataFields:
                    - key: FIRSTNAME
                      value: Nelson
                    - key: LASTNAME
                      value: Redeker
                  preferredLocale: de-DE
                  returnUrlToUseIfChallenged: https://www.mywebsite.com/news
                summary: Request Example
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  contact:
                    type: object
                    properties:
                      id:
                        type: integer
                        default: 0
                        examples:
                        - 23
                      email:
                        type: string
                        examples:
                        - john.smith@emailsim.io
                      optInType:
                        type: string
                        examples:
                        - Unknown
                      emailType:
                        type: string
                        examples:
                        - PlainText
                      dataFields: {}
                      status:
                        type: string
                        examples:
                        - Unsubscribed
                  status:
                    type: string
                    examples:
                    - ContactChallenged
              examples:
                Result:
                  summary: Result
                  value:
                    contact:
                      id: 23
                      email: john.smith@emailsim.io
                      optInType: Unknown
                      emailType: PlainText
                      dataFields: null
                      status: Unsubscribed
                    status: ContactChallenged
  /v2/address-books/{id}/contacts/resubscribe-with-no-challenge:
    parameters:
    - in: header
      name: x-ddg-integration-token
      required: false
      description: If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.
      schema:
        type: string
        pattern: /^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/
        example: 5a96bc79-19a7-4544-973b-e2da0c9136f9
    post:
      summary: Resubscribe contact to list with no challenge
      deprecated: false
      description: Resubscribes a previously unsubscribed contact to a specific list / address book without sending a challenge email
      operationId: resubscribe-contact-to-address-book-with-no-challenge
      tags:
      - Lists / Address books
      parameters:
      - name: id
        in: path
        description: The ID of the list / address book, which needs to be included within the UR

# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dotdigital/refs/heads/main/openapi/dotdigital-lists-address-books-api-openapi.yml