Skip to main content
POST
/
contacts
Create Contact
curl --request POST \
  --url https://api.kejue.co/api/v1/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "phone": "<string>",
  "whatsapp_number": "<string>",
  "email": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "company": "<string>",
  "job_title": "<string>",
  "country": "<string>",
  "timezone": "<string>",
  "language": "<string>",
  "tags": [
    "<string>"
  ],
  "metadata": {}
}
'
{
  "id": "<string>",
  "phone": "<string>",
  "whatsapp_number": "<string>",
  "email": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "company": "<string>",
  "job_title": "<string>",
  "country": "<string>",
  "timezone": "<string>",
  "language": "<string>",
  "tags": [
    "<string>"
  ],
  "metadata": {},
  "source": "<string>",
  "is_active": true,
  "created_at": "<string>",
  "updated_at": "<string>"
}

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