Update global contact | Atlas

Upsert semantics — returns 204 even for an id that does not exist yet (it is created). There is no 404 for this endpoint.

Authentication

api-keystring

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

Path parameters

idstringRequired

Request

This endpoint expects an object.

firstNamestringRequired

Contact’s first name (injected as {{firstName}})

lastNamestringRequired

Contact’s last name (injected as {{lastName}})

phoneNumberstringRequired

Contact’s phone number in E.164 format (e.g. +14155552671). The country code and leading + are required — a national-format number such as 2135050618 is rejected.

timezonestringOptional

Contact’s timezone (e.g. America/New_York)

Response

Contact upserted

Errors

500

Internal Server Error

$	curl -X PUT https://api.youratlas.com/v1/api/contactlist/global/id \
>	-H "api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"firstName": "Emily",
>	"lastName": "Johnson",
>	"phoneNumber": "+14155552671",
>	"timezone": "America/New_York",
>	"appointmentDate": "May 15, 2025",
>	"policyNumber": "POL-12345"
>	}'