Create a contact

POST

//contacts

Creates a new contact in the workspace. At least one of name, email, or phone is required.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200ContactResponse

application/json

Single contact

Bodyapplication/json

🟢201ContactResponse

🟠401Unauthenticated

🟠403Forbidden

🟠422ValidationError

🟠429TooManyRequests

Request Example

Shell

JavaScript

Java

Swift

curl --location '//contacts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

201 - Example 1

{
    "data": {
        "id": "string",
        "name": "string",
        "email": "string",
        "phone": "string",
        "company": "string",
        "job_title": "string",
        "type": "string",
        "lifecycle_stage": "string",
        "source": "string",
        "source_channel": "string",
        "notes": "string",
        "lead_id": "string",
        "conversation_id": "string",
        "last_contacted_at": "2019-08-24T14:15:22.123Z",
        "converted_at": "2019-08-24T14:15:22.123Z",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-08-18 22:47:00

List contacts

View a contact