Update a contact list
Patch a contact list. kind is immutable; rules only apply to dynamic lists, and replacing them recomputes membership.
Authorizations
Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.
Path Parameters
Contact list ID.
Body
At least one field is required.
List name (1-255 chars). Must be unique within the workspace.
1 - 255Optional description (max 1,000 chars). Pass null to clear.
1000Replacement segment rule tree for a dynamic list; membership is recomputed. Not applicable to static lists. email_step conditions are not allowed.
Response
The updated contact list.
Contact list ID.
List name. Unique within the workspace.
static = membership managed manually via the member endpoints; dynamic = membership computed continuously from rules; system = auto-managed by the platform (read-only). Immutable after creation.
static, dynamic, system Creation time.
Last update.
URL-safe identifier derived from the name.
Optional description.
Segment rule tree for dynamic lists; null for static lists.
Stored member count for static lists; null for dynamic lists — use GET /v1/contact-lists/{listId}/member-count for a live count.
Set when the list is a blast's inline audience; null for user-created lists.