Skip to main content
POST
Create a contact

JSON (Basic Contact)

Multipart Form Data (Extended Contact)

If you want to upload an avatar image, assign groups, or set status, you must send the request as multipart/form-data. Example:

📝 Field Requirements


Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspace
string<uuid>
required

ID of the workspace.

Body

application/json
number
string
required

The WhatsApp phone number of the contact

Example:

"+14155550123"

name
string
Maximum string length: 50
Example:

"John Doe"

email
string<email>
gender
enum<string>
Available options:
male,
female,
other
Example:

"male"

Response

status
integer
required
Example:

201

message
string
required
Example:

"Resource created successfully."

data
object
required

Created resource data.