Sign in

v1

latestOpenAPI 3.0.02026-07-1733092.8 KB

patch/v1/contactBooks/{contactBookId}

Path parameters

contactBookIdstring required
Example:clx1234567890

Request body

namestring
emojistring
propertiesobject
doubleOptInEnabledboolean
doubleOptInFromstring nullable
doubleOptInSubjectstring
doubleOptInContentstring
variablesstring[]

Response

Update the contact book

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"
}