Sources

Sources let you track the origin of contacts — “Website”, “Referral”, “Trade Show”, etc. Contacts can be linked to a source to understand your acquisition channels.

The Source Object

Field	Type	Description
id	uuid	Unique identifier
account_id	uuid	Account this source belongs to
created_by	uuid	User who created the source
name	string	Source name
archived_at	datetime | null	When archived, if applicable
created_at	datetime	Creation timestamp
updated_at	datetime	Last update timestamp

List Sources

Endpoint: sources-list

Field	Type	Required	Description
include_archived	boolean	No	Include archived sources (default: false)

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

Get Source

Endpoint: sources-get

Field	Type	Required	Description
id	uuid	Yes	Source ID

Create Source

Endpoint: sources-create

Field	Type	Required	Description
name	string	Yes	Source name

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

Update Source

Endpoint: sources-update

Field	Type	Required	Description
id	uuid	Yes	Source ID
name	string	No	New name

Archive / Unarchive

Endpoint: sources-archive

Field	Type	Required	Description
id	uuid	Yes	Source ID

Endpoint: sources-unarchive

Field	Type	Required	Description
id	uuid	Yes	Source ID

Error Codes

Code	Description
sources.invalid_request	Malformed request body
sources.invalid_id	Invalid UUID format
sources.not_found	Source does not exist
sources.name_required	Name is required
sources.internal	Server error