Activities

Activities are the interactions your team has with contacts, companies, and projects — calls, emails, meetings, and notes. Each activity is logged on a timeline with structured metadata.

The Activity Object

Field	Type	Description
id	uuid
account_id	uuid
created_by	uuid?
activity_type	string
entity_id	uuid
entity_type	string
occurred_at	datetime
metadata	object
created_at	datetime
updated_at	datetime
created_by_name	string
entity_name	string

Create a new activity

Endpoint: activities-create

Field	Type	Required	Description
activity_type	string	Yes
entity_id	string	No
entity_type	string	No
occurred_at	datetime?	No
metadata	object	No

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

Delete an activity

Endpoint: activities-delete

Field	Type	Required	Description
id	string	Yes

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

Get an activity by ID

Endpoint: activities-get

Field	Type	Required	Description
id	string	Yes

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

List activities with optional filters

Endpoint: activities-list

Field	Type	Required	Description
entity_id	string?	No
entity_type	string	No
types	string[]	No
cursor	string	No
limit	int	No

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

Update an existing activity

Endpoint: activities-update

Field	Type	Required	Description
id	string	Yes
occurred_at	datetime?	No
metadata	object?	No

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

List activity type schemas

Endpoint: activity-schemas-list