Create Contact List - AutoSend Documentation

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

string | header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

Contact list or segment data

name

string

required

Name of the contact list (max 200 characters). Must be unique within the project.Maximum length: 200Example: "Newsletter Subscribers"

description

string

Description of the contact list (max 500 characters).Maximum length: 500Example: "Users who signed up for the weekly newsletter"

type

string

Type of contact list.Allowed values: list, segmentDefault: "list"Example: "list"

filterCriteria

object

Filter criteria for segments. Required when type is segment.

Show child attributes

filterCriteria.logicalOperator

string

required

Logical operator for combining groups.Allowed values: AND, ORExample: "AND"

filterCriteria.groups

object[]

required

Array of filter conditions.

Show child attributes

field

string

required

Contact field to filter on.Example: "email"

fieldType

string

required

Data type of the field.Allowed values: string, number, boolean, dateExample: "string"

operator

string

required

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

any

Value to compare against. Not required for unary operators like is_empty and is_not_empty.Example: "@gmail.com"

parentId

string

ID of the parent contact list (for creating sub-segments).Example: "60d5ec49f1b2c72d9c8b4567"

Response

Contact list created successfully

success

boolean

Indicates if the request was successfulExample: true

data

object

The created contact list object

Show child attributes

data.id

string

Unique contact list identifierExample: "60d5ec49f1b2c72d9c8b4567"

data.name

string

Name of the contact listExample: "Newsletter Subscribers"

data.description

string

Description of the contact listExample: "Users who signed up for the weekly newsletter"

data.type

string

Type: list or segmentExample: "list"

data.filterCriteria

object

Filter criteria (for segments only)

data.contactCount

integer

Number of contacts in the listExample: 0

data.parentId

string

Parent list ID (if sub-segment)

data.createdAt

string

ISO 8601 timestamp of creationExample: "2026-03-17T10:30:00.000Z"

data.updatedAt

string

ISO 8601 timestamp of last updateExample: "2026-03-17T10:30:00.000Z"

Get Contact List

Delete Contact List

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

​Body

​Response

Authorizations

Body

Response