Inbound Email

Driftwood gives each account a unique BCC email address. Add it to any outgoing email and the message is automatically logged as an activity on the matching contact.

The Inbound Email Object

Field	Type	Description
id	uuid	Unique identifier of the blocked sender entry
account_id	uuid	ID of the account this block applies to
email	string	Blocked sender email address, if blocking by address
domain	string	Blocked sender domain, if blocking by domain
created_by	uuid	ID of the user who created the block
created_at	datetime	Creation timestamp (ISO 8601)

Block a sender by email or domain

Endpoint: blocked-senders-create

Field	Type	Required	Description
email	string	No	Sender email address to block; provide either email or domain
domain	string	No	Sender domain to block; provide either email or domain

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

Unblock a sender

Endpoint: blocked-senders-delete

Field	Type	Required	Description
id	string	Yes	ID of the blocked sender entry to remove

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

List blocked senders

Endpoint: blocked-senders-list

Get the BCC address for the current user

Endpoint: inbound-emails-bcc-address

Generate a BCC token for the current user

Endpoint: inbound-emails-generate-token

List inbound emails

Endpoint: inbound-emails-list

Field	Type	Required	Description
contact_id	string?	No	Filter to emails matched to this contact ID
company_id	string?	No	Filter to emails matched to this company ID
status	string	No	Filter by processing status One of: processed, unmatched, blocked
cursor	string	No	Opaque pagination cursor from a previous response
limit	int	No	Maximum number of emails to return

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

Rotate the BCC token for the current user

Endpoint: inbound-emails-rotate-token

Error Codes

Code	Description
invalid_request	invalid_request
not_found	not_found
bcc.already_exists	Already exists