POST https://chatloka.net/api/v1/contacts

Create Contact

Create a new contact.

Required scope: contacts:write

How to Use This Endpoint

1. Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Body Parameters

Field	Type	Required	Description
`name`	`string`	Required	Contact name (max 255)
`phone`	`string`	Optional	Unique per organization (max 50)
`email`	`string (email)`	Optional	Unique per organization (max 255)
`avatar`	`string (url)`	Optional	Avatar image URL (max 500)
`label_ids`	`array<integer>`	Optional	Label IDs to attach
`custom_fields`	`object`	Optional	Map of custom field key => value

Request Body

application/json

{
  "name": "John Doe",
  "phone": "+1234567890",
  "email": "john@example.com",
  "label_ids": [1],
  "custom_fields": { "company": "Acme" }
}

Example Request

bash

curl -X POST 'https://chatloka.net/api/v1/contacts' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "John Doe",
  "phone": "+1234567890",
  "email": "john@example.com",
  "label_ids": [1],
  "custom_fields": { "company": "Acme" }
}'

Response

201 Created

application/json

{
  "success": true,
  "data": {
    "id": "9b1c8f20-...",
    "name": "John Doe",
    "phone": "+1234567890",
    "email": "john@example.com",
    "avatar": null,
    "labels": [],
    "tags": [],
    "traffic_sources": [],
    "custom_fields": {},
    "bot_enabled": false,
    "last_contacted_at": null,
    "created_at": "2026-07-14T10:30:00+00:00",
    "updated_at": "2026-07-14T10:30:00+00:00"
  },
  "message": "Contact created successfully"
}

Error Responses

401 UNAUTHORIZED

{ "success": false, "error": { "code": "UNAUTHORIZED", "message": "Invalid or revoked API key" } }

403 FORBIDDEN

{ "success": false, "error": { "code": "FORBIDDEN", "message": "You do not have permission to access this resource." } }

422 VALIDATION_ERROR

{ "success": false, "error": { "code": "VALIDATION_ERROR", "message": "The given data was invalid.", "details": { "field": ["The field is required."] } } }

429 RATE_LIMIT_EXCEEDED

{ "success": false, "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Too many requests. Please slow down.", "retry_after": 60 } }

Back to Contacts

List Contacts Get Contact

Stop Losing Customers
to Slow Responses

Every minute you wait is revenue walking out the door. Join hundreds of businesses who transformed their customer communication with ChatOn.

50%

Faster Response

24/7

AI Support

40%

Higher Conversion

No credit card required

Setup in 5 minutes

Cancel anytime

✓ 30-day money-back guarantee

Create Contact

How to Use This Endpoint

Body Parameters

Request Body

Example Request

Response

Error Responses

Stop Losing Customers
to Slow Responses

🍪 We use cookies

Cookie Preferences

Create Contact

How to Use This Endpoint

Body Parameters

Request Body

Example Request

Response

Error Responses

Stop Losing Customers to Slow Responses

🍪 We use cookies

Cookie Preferences

Stop Losing Customers
to Slow Responses