Inbound
More ways to use this page
Read an inbound domain
GET/v1/
TypeScript sendora
Python sendora
Key sk_… a server key
Parameters
idin pathstring (uuid)requiredThe inbound domain id.
Responses
200A domain on an inbound stream and the two records it needs.
inboundDomainIdstring (uuid)requiredstreamIdstring (uuid)requiredThe inbound stream the domain delivers to.
domainstringrequiredThe domain, lower-cased and IDNA-encoded.
verifiedbooleanrequiredTrue while both records are seen; only then is mail to the domain accepted.
createdAtstring (date-time)requiredlastCheckedAtstring (date-time) or nullrequiredWhen the records were last looked up.
unverifiedAtstring (date-time) or nullrequiredWhen a verified domain lost its records. Mail to it is deferred for 72 hours from then and refused after, until the records are back.
mxobjectrequiredThe MX record that brings the domain’s mail to Sendora, at any priority.
type"MX"requiredhoststringrequiredThe name to create the record under.
valuestringrequiredThe value the record must hold.
verifiedbooleanrequiredverifiedAtstring (date-time) or nullrequired
txtobjectrequiredThe TXT record that proves the claim; it carries a value only you were shown.
type"TXT"requiredhoststringrequiredThe name to create the record under.
valuestringrequiredThe value the record must hold.
verifiedbooleanrequiredverifiedAtstring (date-time) or nullrequired
Example (23 lines)
{
"inboundDomainId": "6c2a9e1d-3f4b-4a8c-9d0e-1b2c3d4e5f60",
"streamId": "b7d2e4f6-1a3c-4d5e-9f80-2c4e6a8b0d1f",
"domain": "post.example.se",
"verified": false,
"createdAt": "2026-09-19T09:00:00.000Z",
"lastCheckedAt": null,
"unverifiedAt": null,
"mx": {
"type": "MX",
"host": "post.example.se",
"value": "10 inbound.sendora.se.",
"verified": false,
"verifiedAt": null
},
"txt": {
"type": "TXT",
"host": "_sendora-inbound.post.example.se",
"value": "sendora-inbound=7f3a9c2e5b1d4f6a8c0e2b4d6f8a1c3e",
"verified": false,
"verifiedAt": null
}
}Errors
Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.
| Code | Status | Meaning |
|---|---|---|
unauthorized | 401 | The key is missing, malformed or revoked. |
wrong_ | 403 | The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes. |
not_ | 404 | No such inbound domain of this server. |