Skip to main content

POST /domains/:id/inbound

Enables inbound email receiving on a verified domain. Creates an SES receipt rule and returns the MX DNS record you need to add.

Authentication

JWT (Dashboard)

Path Parameters

ParameterTypeRequiredDescription
idstringYesDomain ID

Request Body

FieldTypeRequiredDescription
subdomainstringNoSubdomain prefix for receiving (e.g. in). If omitted, receives on root domain.

Response

{
  "message": "Inbound receiving enabled",
  "dnsRecords": [
    {
      "type": "MX",
      "name": "in",
      "value": "10 inbound-smtp.us-east-2.amazonaws.com.",
      "ttl": 3600,
      "description": "Emails to *@in.yourdomain.com will be received by Sendi"
    }
  ],
  "inboundHostname": "in.yourdomain.com"
}

DNS Setup

Add the returned MX record at your DNS provider. Emails sent to *@in.yourdomain.com will then be received by Sendi.