API Reference
Contacts
Custom Fields
Campaigns
Contact Lists
Contact Lists
Create Contact List
Create a new contact list to organize and segment your recipients using the AutoSend API.
POST
/
contact-lists
curl --request POST \
--url https://api.autosend.com/v1/contact-lists \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list"
}'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b4567",
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list",
"contactCount": 0,
"createdAt": "2026-03-17T10:30:00.000Z",
"updatedAt": "2026-03-17T10:30:00.000Z"
}
}
curl --request POST \
--url https://api.autosend.com/v1/contact-lists \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list"
}'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b4567",
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list",
"contactCount": 0,
"createdAt": "2026-03-17T10:30:00.000Z",
"updatedAt": "2026-03-17T10:30:00.000Z"
}
}
Authorizations
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Body
Contact list or segment dataName of the contact list (max 200 characters). Must be unique within the project.Maximum length:
200Example: "Newsletter Subscribers"Description of the contact list (max 500 characters).Maximum length:
500Example: "Users who signed up for the weekly newsletter"Type of contact list.Allowed values:
list, segmentDefault: "list"Example: "list"Filter criteria for segments. Required when
type is segment.Show child attributes
Show child attributes
Logical operator for combining groups.Allowed values:
AND, ORExample: "AND"Array of filter conditions.
Show child attributes
Show child attributes
Contact field to filter on.Example:
"email"Data type of the field.Allowed values:
string, number, boolean, dateExample: "string"Filter operator. Available operators depend on the field type.String operators:
equals, not_equals, contains, not_contains, starts_with, ends_with, is_empty, is_not_emptyNumber operators: equals, not_equals, greater_than, less_than, betweenBoolean operators: equals, not_equalsDate operators: equals, not_equals, before, after, between, is_empty, is_not_emptyExample: "contains"Value to compare against. Not required for unary operators like
is_empty and is_not_empty.Example: "@gmail.com"ID of the parent contact list (for creating sub-segments).Example:
"60d5ec49f1b2c72d9c8b4567"Response
Contact list created successfullyIndicates if the request was successfulExample:
trueThe created contact list object
Show child attributes
Show child attributes
Unique contact list identifierExample:
"60d5ec49f1b2c72d9c8b4567"Name of the contact listExample:
"Newsletter Subscribers"Description of the contact listExample:
"Users who signed up for the weekly newsletter"Type:
list or segmentExample: "list"Filter criteria (for segments only)
Number of contacts in the listExample:
0Parent list ID (if sub-segment)
ISO 8601 timestamp of creationExample:
"2026-03-17T10:30:00.000Z"ISO 8601 timestamp of last updateExample:
"2026-03-17T10:30:00.000Z"⌘I
curl --request POST \
--url https://api.autosend.com/v1/contact-lists \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list"
}'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b4567",
"name": "Newsletter Subscribers",
"description": "Users who signed up for the weekly newsletter",
"type": "list",
"contactCount": 0,
"createdAt": "2026-03-17T10:30:00.000Z",
"updatedAt": "2026-03-17T10:30:00.000Z"
}
}