Contacts API

Manage contacts programmatically.

Endpoints

List Contacts

GET /api/v1/contacts

Query Parameters:

Parameter	Type	Description
page	number	Page number (default: 1)
limit	number	Per page (default: 20, max: 100)
search	string	Search by name, email, phone
tags	string	Filter by tag
source	string	Filter by source channel

Get Contact

GET /api/v1/contacts/:id

Create Contact

POST /api/v1/contacts

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "phone": "+905551234567",
  "tags": ["vip", "customer"],
  "customFields": {
    "company": "Acme Inc."
  }
}

Update Contact

PATCH /api/v1/contacts/:id

Delete Contact

DELETE /api/v1/contacts/:id

Add Note

POST /api/v1/contacts/:id/notes

{
  "content": "Customer interested in premium plan"
}