Inbound Email

Driftwood provides each user with a unique BCC address. Forward or BCC emails to this address to automatically log them as activities on the matching contact.

How It Works

1. Each user gets a unique BCC email address (e.g., user-token@bcc.driftwoodapp.com)
2. When you BCC this address on an email, Driftwood receives it
3. Driftwood matches the email’s recipients to contacts in your account
4. An email activity is automatically created on the matched contact

Get BCC Address

Endpoint: inbound-emails-bcc-address

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

Response:

{
  "ok": true,
  "result": {
    "address": "abc123@bcc.driftwoodapp.com"
  }
}

Regenerate BCC Token

If your BCC address is compromised, generate a new one. The old address will stop working immediately.

Endpoint: inbound-emails-generate-token

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

Rotate BCC Token

Endpoint: inbound-emails-rotate-token

Same as generate but replaces an existing token.

List Inbound Emails

View processed inbound emails and their matching status.

Endpoint: inbound-emails-list

Field	Type	Required	Description
contact_id	uuid	No	Filter by matched contact
company_id	uuid	No	Filter by matched company
status	string	No	Filter by status
cursor	string	No	Pagination cursor
limit	integer	No	Results per page

Response includes:

Field	Type	Description
id	uuid	Email ID
from_address	string	Sender email
to_addresses	string[]	Recipients
cc_addresses	string[]	CC recipients
subject	string	Email subject
body_text	string	Plain text body
body_html	string	HTML body
contact_id	uuid | null	Matched contact
contact_name	string	Matched contact name
status	string	Processing status
created_at	datetime	When received

Blocked Senders

Block specific email addresses or domains from creating activities.

List Blocked Senders

Endpoint: blocked-senders-list

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

Block a Sender

Endpoint: blocked-senders-create

Field	Type	Required	Description
email	string	No*	Block a specific email address
domain	string	No*	Block an entire domain

*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 '{"domain": "spam-domain.com"}'

Unblock a Sender

Endpoint: blocked-senders-delete

Field	Type	Required	Description
id	uuid	Yes	Blocked sender ID