v1

latestSwagger 2.0MIT2026-07-17233380637.0 KB

Contacts

Add existing contacts to a list

post/contacts/lists/{listId}/contacts/add

Path parameters

listIdinteger required

Id of the list

Request body

emailsstring[]

Mandatory if IDs are not passed, ignored otherwise. Emails to add to a list. You can pass a maximum of 150 emails for addition in one request. If you need to add the emails in bulk, please prefer /contacts/import api.

idsinteger[]

Mandatory if Emails are not passed, ignored otherwise. Emails to add to a list. You can pass a maximum of 150 emails for addition in one request. If you need to add the emails in bulk, please prefer /contacts/import api.

Example request

{
  "emails": [
    "john.smith@contact.com"
  ],
  "ids": [
    121
  ]
}

Response

All contacts have been added successfully to the list with details of failed ones

Example response

{
  "contacts": {
    "total": 27,
    "processId": 78,
    "success": [
      "jeff32@example.com, jim56@example.com",
      "jeff32@example.com, jim56@example.com"
    ],
    "failure": [
      "jeff32@example.com, jim56@example.com",
      "jeff32@example.com, jim56@example.com"
    ]
  }
}