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"
    }
  ]
}'

{
  "processed": [
    {
      "PartitionKey": "contacts",
      "RowKey": "michael.thompson+14155551234",
      "Timestamp": "2024-01-15T09:30:00Z",
      "FirstName": "Michael",
      "LastName": "Thompson",
      "Timezone": "America/Los_Angeles",
      "TimezoneIANA": "America/Los_Angeles",
      "TimezoneFriendly": "Pacific Time (US & Canada)"
    }
  ],
  "invalid": [
    {
      "firstName": "Anna",
      "lastName": "Smith",
      "phoneNumber": "12345",
      "timezone": "Europe/London",
      "errors": [
        "Invalid phone number format"
      ]
    }
  ]
}

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

Response

Contacts processed. The server validates phone numbers and returns the accepted contacts under processed and the rejected ones under invalid.

processedlist of objects

invalidlist of objects

Errors

400

Bad Request Error

500

Internal Server Error