Skip to content
Home/
REST API Reference
/
/
Update Audience Request

Update Audience Request

The request payload for updating an audience. All fields are optional — only provided fields will be updated.

namestring

The name of the audience.

Example:"Enterprise Accounts"
predicatesArray of objects(Predicate)

The predicates that define which contacts belong to the audience.

Example:
[
  {
    "attribute": "custom_attributes.plan",
    "type": "string",
    "comparison": "eq",
    "value": "enterprise"
  }
]
role_predicatesArray of objects(Predicate)

Role-based predicates that further filter audience membership by contact role.

Example:
[
  {
    "attribute": "role",
    "type": "role",
    "comparison": "eq",
    "value": "user"
  }
]
{
  "name": "Enterprise Accounts",
  "predicates": [
    { … }
  ],
  "role_predicates": [
    { … }
  ]
}