Subscribe contact to topic

Subscribe a contact to a topic. Returns 201 if the subscription is new, or 200 if the contact was already subscribed. Requires the audience:write scope and is blocked for sandbox API keys.

POST /audience/contacts/{contactId}/topics/{topicId}

Subscribe contact to topic

cURL

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

200

Example

{
  "message": "Contact subscribed to topic."
}

Subscribe a contact to a topic. Returns 201 if the subscription is new, or 200 if the contact was already subscribed. 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

topicId · string<uuid> · required

Topic ID

Response

200

application/json

Contact was already subscribed

message · string · required

Example:

"Contact subscribed to topic."