Contacts

POST /api/v1/contacts

Create a contact.

Field	Type	Required	Description
`firstName`	string	Yes	First name
`lastName`	string	No	Last name
`phoneNumbers`	string[]	No	Phone numbers in E.164 format
`emailAddresses`	string[]	No	Email addresses
`appleId`	string	No	Apple ID if different from email
`organization`	string	No	Company name
`jobTitle`	string	No	Job title
`tags`	string[]	No	Tags for filtering and grouping
`notes`	string	No	Free-form notes

The created contact object.

List contacts.

Parameter	Type	Default	Description
`search`	string	—	Search by name, phone, email, or tag
`tags`	string	—	Comma-separated tag filter
`page`	number	1	Page number
`limit`	number	20	Results per page

Get a single contact.

Update a contact. Partial updates — only include fields you want to change.

Delete a contact.

Bulk import contacts from a CSV or JSON file. Send as multipart/form-data.

{
  "created": 45,
  "updated": 3,
  "failed": 2,
  "errors": [
    { "row": 12, "error": "Invalid phone number format" }
  ]
}

Export contacts as CSV or JSON.

Parameter	Type	Default	Description
`format`	string	`json`	`csv` or `json`
`search`	string	—	Same filters as list endpoint
`tags`	string	—	Same filters as list endpoint

Create a contact group.

Field	Type	Required	Description
`name`	string	Yes	Group name

List all contact groups.

Add a contact to a group.

Field	Type	Required	Description
`contactId`	string	Yes	Contact ID to add

Remove a contact from a group.