Audience

Bulk attach contacts to lists

Attach every combination of contact_ids × list_ids (up to 1000 contacts × 50 lists). Existing pairs are reported in already_attached. Requires the audience:write scope and is blocked for sandbox API keys.

post/audience/contacts/lists/bulk

Request

  • Base URL: https://app.lettr.com/api
  • URL: https://app.lettr.com/api/audience/contacts/lists/bulk
  • Auth: HTTP bearer

Request body

contact_idsstring[] required
list_idsstring[] required

Response

OK

messagestring required

Example response

{
  "message": "Contacts attached to lists."
}

Changes

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