Attach contact to list

Add a contact to a list. Returns 201 if the contact was newly attached, or 200 if the contact was already in the list. Requires the audience:write scope and is blocked for sandbox API keys.

POST /audience/contacts/{contactId}/lists/{listId}

Attach contact to list

cURL

curl --request POST \
  --url https://app.lettr.com/api/audience/contacts/{contactId}/lists/{listId} \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "message": "Contact attached to list."
}

Add a contact to a list. Returns 201 if the contact was newly attached, or 200 if the contact was already in the list. Requires the audience:write scope and is blocked for sandbox API keys.

Authorizations

Authorization · string · header · required

API key for authentication

Path Parameters

contactId · string<uuid> · required

Contact ID

listId · string<uuid> · required

List ID

Response

200

application/json

Contact was already in the list

message · string · required

Example:

"Contact attached to list."