Docs
DashboardGet API key
API · inboxes

Create an inbox

Give a receiving-enabled domain a real address that can take mail in. Once created, inbound messages to it land in threads you can read and reply to.

POST/v1/inboxes

An inbox is an address on a domain that has receiving turned on. The address's domain part must match a domain you own and that domain's MX record must resolve to Drin before mail will route in.

01 Body

addressstringRequired
The full receive address, for example support@acme.com. Its domain must be a receiving-enabled domain you own.
domainIdstringRequired
The id of the receiving domain this inbox belongs to.
displayNamestringOptional
A human-friendly name shown alongside the address, for example Acme Support.

02 Request

curl https://api.drin.run/v1/inboxes \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "support@acme.com",
    "domainId": "dom_01HZ8K3M9P",
    "displayName": "Acme Support"
  }'

03 Response

201 Created — the inbox. Pass its id as ?inboxId= when listing threads to scope the feed to this address.

JSON
{
  "id": "inb_01HZ9C7R2K",
  "senderId": "snd_01HZ0A1B2C",
  "domainId": "dom_01HZ8K3M9P",
  "address": "support@acme.com",
  "displayName": "Acme Support",
  "type": "sending",
  "createdAt": "2026-06-02T09:12:00Z"
}
Test without DNSYou can exercise the whole inbound path — inbox to thread to webhook — without waiting on MX by calling simulate inbound.