Create a contact list
Create a contact list. Choose static (fixed membership) or dynamic (rule-driven) explicitly — the kind cannot be changed later.
Authorizations
Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.
Body
List name (1-255 chars). Must be unique within the workspace.
1 - 255static = membership managed manually via the member endpoints; dynamic = membership computed continuously from rules. Immutable after creation.
static, dynamic Optional description (max 1,000 chars). Pass null to clear.
1000Segment rule tree for a dynamic list (a dynamic list without rules has no members). Must be omitted or null for static lists. email_step conditions are not allowed.
Initial members for a static list (max 500 per request; add more via the members endpoint). Not allowed for dynamic lists.
500Response
Contact list created.
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.