Contacts

Create a contact

Create a contact and optionally assign lifecycle and owner metadata.

Overview

Use this API to create a contact and optionally assign lifecycle and owner metadata. It requires bearer api key authentication and the contacts:write scope.

POST/contacts

cURL

POST

bash

curl --request POST \  --url 'https://api.atlascrm.dev/v1/contacts' \  --header 'Authorization: Bearer crm_live_xxx' \  --header 'Content-Type: application/json' \  --data '{  "email": "maya@example.com",  "firstName": "Maya",  "lastName": "Patel",  "lifecycleStage": "lead"}'

Authorization

Bearer API key

contacts:write

Sample Request Body

json

{  "email": "maya@example.com",  "firstName": "Maya",  "lastName": "Patel",  "lifecycleStage": "lead"}

Sample Response

json

{  "status": "success",  "data": {    "id": "con_456",    "email": "maya@example.com",    "firstName": "Maya",    "lastName": "Patel",    "lifecycleStage": "lead"  }}

Status Codes

Code	Description
201	Contact was created.

Headers

AuthorizationstringRequired

Bearer token for your workspace.

Example: Bearer crm_live_xxx

Idempotency-KeystringOptional

Unique key used to avoid duplicate contact creation.

Object	Description
Authorization string	RequiredBearer token for your workspace. Example: Bearer crm_live_xxx
Idempotency-Key string	OptionalUnique key used to avoid duplicate contact creation.

Request body

emailstringRequired

Primary email address.

Example: maya@example.com

firstNamestringOptional

First name.

Example: Maya

lastNamestringOptional

Last name.

Example: Patel

lifecycleStagestringOptional

Lifecycle stage for segmentation.

Example: lead

Object	Description
email string	RequiredPrimary email address. Example: maya@example.com
firstName string	OptionalFirst name. Example: Maya
lastName string	OptionalLast name. Example: Patel
lifecycleStage string	OptionalLifecycle stage for segmentation. Example: lead

Response fields

data.idstring

Contact identifier.

data.emailstring

Primary email address.

Object	Description
data.id string	Contact identifier.
data.email string	Primary email address.