Skip to main content
PATCH
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.

Authorizations

Authorization
string
header
required

API key for authentication

Path Parameters

listId
string<uuid>
required

List ID

Body

application/json

Request to update an audience list. All fields are optional.

name
string

New list name (must remain unique within the team)

Maximum string length: 255
Example:

"Newsletter subscribers (renamed)"

Response

Updated

message
string
required
Example:

"List retrieved successfully."

data
object
required

Audience list summary