Receive Email (Human Inboxes)

Consume inbound mail from connected Human Inboxes using routing subscriptions.

View as Markdown

For Human Inboxes, the preferred receive model is smart routing subscriptions.

Create subscription

POST /human/v0/webhooks/subscriptions
{
  "human_account_id": "ha_123",
  "target_url": "https://example.com/human-events",
  "event_types": ["message.received"]
}

Process events

Your handler receives human mailbox events with account + message identifiers so you can fetch additional context as needed.

Fetch relationship context

GET /human/v0/contacts/{email_address}/relationship