Skip to content
Responsly API Docs

Create contacts - bulk

POST

https://api.responsly.com/v1/contacts/bulk

Body parameters

  • list_id (string, required): Contact List ID to which the contact should be added.
  • contacts (array, required): An array of contacts to be added to the contact list. Example:
[
  {
    "name": "Contact Name",
    "email": "example@example.com",
    "data": {
        "phone": "+48123123123",
        "city": "New York"
    }
  }
]

Request

cURL

Terminal window
curl --request POST \
 --url 'https://api.responsly.com/v1/contacts/bulk' \
 --header 'Authorization: Bearer <Access Token>' \
 --header 'Content-Type: application/json' \
 --data '{
   "list_id": "YOUR_LIST_ID",
   "contacts": [
     {
       "name": "Contact Name",
       "email": "example@example.com",
       "data": {
           "phone": "+48123123123",
           "city": "New York"
       }
     }
   ]
 }'

Response

{
  "added_contacts": [
    {
      "name": "Contact Name",
      "email": "example@example.com",
      "list_id": "AYQxr02LnOPdZ8oQ9safaoqBpwKzWmRkMD15",
      "data": "{\"phone\":\"+48123123123\", \"city\":\"New York\"}",
      "updated_at": "2024-07-30T12:16:52.000000Z",
      "created_at": "2024-07-30T12:16:52.000000Z",
      "id": "OByJrP130d6lMgf3fgGyBdWRnV97LbEZqjep"
    }
  ],
  "contact_list_id": "AYQxr02LnOPdZ8oQ9safaoqBpwKzWmRkMD15"
}

Status Code: 201 Created