Skip to main content
POST
Create List
Create a new contact list for organizing email recipients with optional custom field definitions.

Request Body

string
required
List name (max 100 characters).
string
Optional description (max 500 characters).
array
Custom field definitions for contacts in this list.

Examples

Response

string
Unique list ID.
string
List name.
string
List description.
array
Custom field definitions.
integer
Number of contacts (0 for new lists).
string
ISO 8601 timestamp when created.
string
ISO 8601 timestamp when last updated.
Example Response

Custom Field Types

Custom fields are defined at the list level. All contacts in a list share the same field schema.