Skip to main content
POST
Create Contact

Authorizations

X-API-Key
string
header
required

Workspace API key (e.g. kej_live_...)

Body

application/json

Create a contact. All fields optional.

phone
string | null

Phone number (E.164 recommended)

whatsapp_number
string | null

WhatsApp number (E.164)

email
string | null

Email address

first_name
string | null

First name

last_name
string | null

Last name

company
string | null

Company name

job_title
string | null

Job title

country
string | null

ISO country code

timezone
string | null

IANA timezone

language
string | null

Language code

tags
string[]

Tags

metadata
Metadata · object

Custom key-value metadata

Response

Successful Response

A contact (public-safe response).

id
string
required
phone
string | null
whatsapp_number
string | null
email
string | null
first_name
string | null
last_name
string | null
company
string | null
job_title
string | null
country
string | null
timezone
string | null
language
string | null
tags
string[]
metadata
Metadata · object
source
string | null
is_active
boolean
default:true
created_at
string | null
updated_at
string | null