Sources

Sources track where your contacts come from — website, referral, LinkedIn, events, etc. Assign a source to each contact to measure which channels drive the most leads.

The Source Object

Field	Type	Description
id	uuid	Unique identifier of the source (UUID).
account_id	uuid	ID of the account that owns this source (UUID).
created_by	uuid	ID of the user who created this source (UUID).
name	string	Display name of the source.
archived_at	datetime?	Timestamp when the source was archived (ISO 8601), or null if active.
created_at	datetime	Timestamp when the source was created (ISO 8601).
updated_at	datetime	Timestamp when the source was last updated (ISO 8601).

Archive a source

Endpoint: sources-archive

Field	Type	Required	Description
id	string	Yes	ID of the source to archive (UUID).

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

Create a new source

Endpoint: sources-create

Field	Type	Required	Description
name	string	Yes	Display name of the source. Required and must be non-empty after trimming.

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

Get a source by ID

Endpoint: sources-get

Field	Type	Required	Description
id	string	Yes	ID of the source to retrieve (UUID).

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

List sources

Endpoint: sources-list

Field	Type	Required	Description
include_archived	bool	No	When true, include archived sources in the results; defaults to false.

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

Unarchive a source

Endpoint: sources-unarchive

Field	Type	Required	Description
id	string	Yes	ID of the source to unarchive (UUID).

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

Update a source

Endpoint: sources-update

Field	Type	Required	Description
id	string	Yes	ID of the source to update (UUID). Required.
name	string	Yes	New display name of the source. Required and must be non-empty after trimming.

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

Error Codes

Code	Description
sources.invalid_request	invalid request body
sources.invalid_id	invalid source ID
sources.not_found	source not found
sources.name_required	name is required