Skip to main content
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
  }
}

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
  }
}

​
Authorizations

​
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
required
The ID of the contact list to add contacts to.Example: "60d5ec49f1b2c72d9c8b4567"
​
emails
string[]
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