Skip to navigation
Atlas APIContacts

Create contact manually

Adds one or more contacts to a campaign without uploading a CSV. Each contact is validated independently — see the 200 response, which returns accepted contacts under processed and rejected ones under invalid.

Authentication

api-keystring

Your Atlas API key. Get it from the Atlas Portal under Settings > API Keys.

Request

This endpoint expects an object.
contactslist of objectsRequired
campaignIdstringOptional

Campaign to attach the contacts to. Omit it and the contacts are created as global contacts only — they will not be dialed by any campaign.

Response

Contacts processed. Each contact is validated independently and the response is 200 even when every contact is rejected — always check invalid, and treat an empty processed array as a failure. invalid entries carry an errors array (for example Invalid last name, Invalid phone number).

processedlist of objectsOptional
invalidlist of objectsOptional

Errors

400
Bad Request Error
500
Internal Server Error