Create contact manually | Atlas

curl -X POST https://api.youratlas.com/v1/api/contactlist/contactlistmanual \
     -H "api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "contacts": [
    {
      "firstName": "Michael",
      "lastName": "Thompson",
      "phoneNumber": "+14155551234"
    },
    {
      "firstName": "Sarah",
      "lastName": "Williams",
      "phoneNumber": "+442071838750"
    }
  ]
}'

{
  "processed": [
    {
      "PartitionKey": "campaign-987654321",
      "RowKey": "contact-123456789",
      "Timestamp": "2024-01-15T09:30:00Z",
      "FirstName": "Michael",
      "LastName": "Thompson",
      "Timezone": "America/New_York",
      "TimezoneIANA": "America/New_York",
      "TimezoneFriendly": "Eastern Standard Time"
    }
  ],
  "invalid": [
    {
      "firstName": "Sarah",
      "lastName": "Williams",
      "phoneNumber": "2071838750",
      "timezone": "Europe/London",
      "errors": [
        "Invalid phone number"
      ]
    }
  ]
}

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).

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