Audience

Update an audience list

Partially update an audience list. If no fields are provided the existing list is returned unchanged. Requires the audience:write scope and is blocked for sandbox API keys.

patch/audience/lists/{listId}

Request

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

Path parameters

listIdstring uuid required

List ID

Request body

namestring

New list name (must remain unique within the team)

Example request

{
  "name": "Newsletter subscribers (renamed)"
}

Response

Updated

messagestring required

Example response

{
  "message": "List retrieved successfully.",
  "data": {
    "id": "0193e6a8-1f3a-7c2a-b9e2-1aa1d2e5d3f0",
    "name": "Newsletter subscribers",
    "contacts_count": 124
  }
}

Changes

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