Inbound

Claim a domain for an inbound stream

Claims the domain for one of the server’s inbound streams and answers the two DNS records to add: an MX that brings the domain’s mail to Sendora and a TXT record that proves the claim. Mail to any address on the domain is accepted once both records are seen, which Sendora checks on its own and on request. A stream holds one domain; the first account to verify a name holds it.

post/v1/inbound/domains

Request

  • Base URL: https://api.sendora.se
  • URL: https://api.sendora.se/v1/inbound/domains
  • Auth: HTTP bearer

Request body

streamIdstring uuid required

An inbound stream of the server.

domainstring required

The domain mail is sent from, such as example.se; lower-cased and IDNA-encoded.

Response

A domain on an inbound stream and the two records it needs.

inboundDomainIdstring uuid required
streamIdstring uuid required

The inbound stream the domain delivers to.

domainstring required

The domain, lower-cased and IDNA-encoded.

verifiedboolean required

True while both records are seen; only then is mail to the domain accepted.

createdAtstring date-time required
lastCheckedAtstring date-time nullable required

When the records were last looked up.

unverifiedAtstring date-time nullable required

When a verified domain lost its records. Mail to it is deferred for 72 hours from then and refused after, until the records are back.

Changes

No recorded changes to this operation across all 1 revision of this API.