Contacts

Contacts are the core records in Driftwood — the people your team interacts with. Contacts can be associated with companies, tagged, and have custom fields.

The Contact Object

Field	Type	Description
id	uuid
account_id	uuid
created_by	uuid
first_name	string
last_name	string
email	string
phone	string
company_id	uuid?
company_name	string
job_title	string
address	string
city	string
state	string
zip_code	string
country	string
notes	string
tags	string[]
source_id	uuid?
source_name	string
custom_fields	object
created_at	datetime
updated_at	datetime

Create a new contact

Endpoint: contacts-create

Field	Type	Required	Description
first_name	string	Yes
last_name	string	No
email	string	No
phone	string	No
company_id	string?	No
job_title	string	No
address	string	No
city	string	No
state	string	No
zip_code	string	No
country	string	No
notes	string	No
tags	string[]	No
source_id	string?	No
custom_fields	object?	No

curl -X POST https://api.driftwoodapp.com/api/contacts-create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "..."}'

Delete a contact

Endpoint: contacts-delete

Field	Type	Required	Description
id	string	Yes

curl -X POST https://api.driftwoodapp.com/api/contacts-delete \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "..."}'

Get a contact by ID

Endpoint: contacts-get

Field	Type	Required	Description
id	string	Yes

curl -X POST https://api.driftwoodapp.com/api/contacts-get \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "..."}'

List contacts with filtering and pagination

Endpoint: contacts-list

Field	Type	Required	Description
search	string	No
tags	string[]	No
company_id	string?	No
company_ids	string[]	No
source_ids	string[]	No
cursor	string	No
limit	int	No

curl -X POST https://api.driftwoodapp.com/api/contacts-list \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Update an existing contact

Endpoint: contacts-update

Field	Type	Required	Description
id	string	Yes
first_name	string?	No
last_name	string?	No
email	string?	No
phone	string?	No
company_id	string?	No
job_title	string?	No
address	string?	No
city	string?	No
state	string?	No
zip_code	string?	No
country	string?	No
notes	string?	No
tags	string[]	No
source_id	string?	No
custom_fields	object?	No

curl -X POST https://api.driftwoodapp.com/api/contacts-update \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "..."}'

Error Codes

Code	Description
contacts.first_name_required	First name required
contacts.invalid_company_id	Invalid company id
contacts.invalid_source_id	Invalid source id
contacts.invalid_custom_fields	Invalid custom fields
contacts.invalid_id	Invalid id
contacts.not_found	Not found