Skip to main content
POST
/
audience
/
contacts
/
{contactId}
/
lists
/
{listId}
Attach contact to list
curl --request POST \
  --url https://app.lettr.com/api/audience/contacts/{contactId}/lists/{listId} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Contact attached to list."
}

Documentation Index

Fetch the complete documentation index at: https://docs.lettr.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Contact was already in the list

​
message
string
required
Example:

"Contact attached to list."