Bulk Add Contacts to List - AutoSend Documentation

POST

contact-lists

contacts

bulk-add

curl --request POST \
  --url https://api.autosend.com/v1/contact-lists/contacts/bulk-add \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contactListId": "60d5ec49f1b2c72d9c8b4567",
  "emails": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ]
}'

{
  "success": true,
  "data": {
    "added": 2,
    "created": 1,
    "alreadyInList": 0,
    "errors": [],
    "validation": {
      "valid": [
        { "email": "[email protected]", "status": "valid" },
        { "email": "[email protected]", "status": "valid" },
        { "email": "[email protected]", "status": "valid" }
      ],
      "invalid": [],
      "suppressed": []
    },
    "totalContactsInList": 343,
    "contacts": [
      {
        "id": "6a27dd38aa5fe8d43df734d4",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      },
      {
        "id": "6a27dd38aa5fe8d43df734d5",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      },
      {
        "id": "6a27dd38aa5fe8d43df734d6",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      }
    ]
  }
}

curl --request POST \
  --url https://api.autosend.com/v1/contact-lists/contacts/bulk-add \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contactListId": "60d5ec49f1b2c72d9c8b4567",
  "emails": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ]
}'

{
  "success": true,
  "data": {
    "added": 2,
    "created": 1,
    "alreadyInList": 0,
    "errors": [],
    "validation": {
      "valid": [
        { "email": "[email protected]", "status": "valid" },
        { "email": "[email protected]", "status": "valid" },
        { "email": "[email protected]", "status": "valid" }
      ],
      "invalid": [],
      "suppressed": []
    },
    "totalContactsInList": 343,
    "contacts": [
      {
        "id": "6a27dd38aa5fe8d43df734d4",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      },
      {
        "id": "6a27dd38aa5fe8d43df734d5",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      },
      {
        "id": "6a27dd38aa5fe8d43df734d6",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      }
    ]
  }
}

Authorizations

string | header

required

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

Body

Add contacts to a list by email addresses or contact IDs. Provide either emails or contactIds, not both.

contactListId

string

The ID of the contact list to add contacts to.Example: "60d5ec49f1b2c72d9c8b4567"

emails

string[]

required

Array of email addresses to add to the list. New contacts will be created for emails that don’t already exist.

Maximum 500 emails per request. Provide either emails or contactIds, not both.

Example:

["[email protected]", "[email protected]", "[email protected]"]

contactIds

string[]

Array of existing contact IDs to add to the list.

Maximum 500 contact IDs per request. Provide either emails or contactIds, not both.

Example:

["60d5ec49f1b2c72d9c8b1111", "60d5ec49f1b2c72d9c8b2222"]

Response

Contacts added to list

success

boolean

Indicates if the request was successfulExample: true

data

object

Show child attributes

data.added

integer

Number of existing contacts added to the listExample: 2

data.created

integer

Number of new contacts created and added to the listExample: 1

data.alreadyInList

integer

Number of contacts that were already in the listExample: 0

data.errors

object[]

Array of errors for contacts that failed to be added

Show child attributes

string

The email address that failed

error

string

Error description

data.validation

object

Email validation results

Show child attributes

validation.valid

object[]

Successfully validated emails

Show child attributes

string

Email address

status

string

Validation status

validation.invalid

object[]

Emails that failed validation

Show child attributes

string

Email address

status

string

Validation status

reason

string

Reason for invalidation

validation.suppressed

object[]

Emails that were suppressed

data.totalContactsInList

integer

Total number of contacts now in the listExample: 343

data.contacts

object[]

Array of contact objects that were added or created

Show child attributes

string

Unique identifier for the contact

string

Email address of the contact

createdAt

string

ISO 8601 timestamp when the contact was created

updatedAt

string

ISO 8601 timestamp when the contact was last updated

projectId

string

ID of the project the contact belongs to

listIds

string[]

IDs of contact lists the contact belongs to

segmentIds

string[]

IDs of segments the contact belongs to

Get Contacts in List

Remove Contacts from List

curl --request POST \
  --url https://api.autosend.com/v1/contact-lists/contacts/bulk-add \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contactListId": "60d5ec49f1b2c72d9c8b4567",
  "emails": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ]
}'

{
  "success": true,
  "data": {
    "added": 2,
    "created": 1,
    "alreadyInList": 0,
    "errors": [],
    "validation": {
      "valid": [
        { "email": "[email protected]", "status": "valid" },
        { "email": "[email protected]", "status": "valid" },
        { "email": "[email protected]", "status": "valid" }
      ],
      "invalid": [],
      "suppressed": []
    },
    "totalContactsInList": 343,
    "contacts": [
      {
        "id": "6a27dd38aa5fe8d43df734d4",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      },
      {
        "id": "6a27dd38aa5fe8d43df734d5",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      },
      {
        "id": "6a27dd38aa5fe8d43df734d6",
        "email": "[email protected]",
        "updatedAt": "2026-06-09T09:30:32.172Z",
        "createdAt": "2026-06-09T09:30:32.172Z",
        "projectId": "6a045963cbaa3dd6f0f7da61",
        "listIds": ["60d5ec49f1b2c72d9c8b4567"],
        "segmentIds": []
      }
    ]
  }
}

​Authorizations

​Body

​Response

Authorizations

Body

Response