Sign in

v1

latestOpenAPI 3.0.02026-07-1733092.8 KB

get/v1/contactBooks

Response

Retrieve contact books accessible by the API key

idstring required

The ID of the contact book

namestring required

The name of the contact book

teamIdnumber required

The ID of the team

propertiesobject required

Custom properties for the contact book

variablesstring[] required

Allowed personalization variables for contacts in this book

emojistring required

The emoji associated with the contact book

doubleOptInEnabledboolean

Whether double opt-in is enabled for new contacts

doubleOptInFromstring nullable

From address used for double opt-in emails (must use a verified domain)

doubleOptInSubjectstring nullable

Subject line used for double opt-in confirmation email

doubleOptInContentstring nullable

Email editor JSON content used for double opt-in confirmation

createdAtstring required

The creation timestamp

updatedAtstring required

The last update timestamp

Example response

[
  {
    "id": "clx1234567890",
    "name": "Newsletter Subscribers",
    "teamId": 1,
    "properties": {
      "customField1": "value1"
    },
    "variables": [
      "registrationCode",
      "company"
    ],
    "emoji": "📙",
    "doubleOptInEnabled": true,
    "doubleOptInFrom": "Newsletter <hello@example.com>",
    "doubleOptInSubject": "Please confirm your subscription"
  }
]