Audience

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}

Request

  • Base URL: https://app.lettr.com/api
  • URL: https://app.lettr.com/api/audience/contacts/{contactId}/lists/{listId}
  • Auth: HTTP bearer

Path parameters

contactIdstring uuid required

Contact ID

listIdstring uuid required

List ID

Response

Contact was already in the list

messagestring required

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.