Developer Docs

Contacts API

Create, update, and manage contacts. Organize with labels, tags, and custom fields.

Reading uses contacts:read; writing uses contacts:write.

GET /contacts

List Contacts

List all contacts with optional filters and pagination.

Scope: contacts:read
View Documentation
POST /contacts

Create Contact

Create a new contact.

Scope: contacts:write
View Documentation
GET /contacts/{uuid}

Get Contact

Get a single contact by UUID.

Scope: contacts:read
View Documentation
PATCH /contacts/{uuid}

Update Contact

Update a contact. All body parameters are optional.

Scope: contacts:write
View Documentation
DELETE /contacts/{uuid}

Delete Contact

Soft-delete a contact.

Scope: contacts:write
View Documentation
GET /contacts/{uuid}/notes

List Contact Notes

List notes for a contact.

Scope: contacts:read
View Documentation
POST /contacts/{uuid}/notes

Add Contact Note

Add a note to a contact.

Scope: contacts:write
View Documentation
PATCH /contacts/{uuid}/notes/{note}

Update Contact Note

Update a contact note.

Scope: contacts:write
View Documentation
DELETE /contacts/{uuid}/notes/{note}

Delete Contact Note

Delete a contact note.

Scope: contacts:write
View Documentation
POST /contacts/{uuid}/labels/{labelId}

Attach Label

Attach a label to a contact.

Scope: contacts:write
View Documentation
DELETE /contacts/{uuid}/labels/{labelId}

Detach Label

Detach a label from a contact.

Scope: contacts:write
View Documentation
POST /contacts/{uuid}/tags/{tagId}

Attach Tag

Attach a tag to a contact.

Scope: contacts:write
View Documentation
DELETE /contacts/{uuid}/tags/{tagId}

Detach Tag

Detach a tag from a contact.

Scope: contacts:write
View Documentation
GET /contacts/{uuid}/conversations

List Contact Conversations

List all conversations for a specific contact across all channels.

Scope: contacts:read
View Documentation
Start Today

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

πŸͺ We use cookies

We use cookies and similar technologies to improve your experience, analyze traffic, and personalize content. By clicking "Accept All", you consent to our use of cookies. Privacy Policy & Cookie Policy.

Cookie Preferences

Choose which cookies you want to allow. Essential cookies are always required for the website to function.

Essential Cookies

Required for the website to function. Cannot be disabled.

Always On

Analytics Cookies

Help us understand how visitors interact with our website by collecting anonymous data.

Marketing Cookies

Used to track visitors across websites to display relevant advertisements.

βœ… Preferences saved!