Create an exact-address route
POST/api/domains/:id/routes
x-audience: "management"
x-required-scope: "domains:write"
Creates an exact local-part route to an endpoint in this account. UTF-8 local parts are trimmed, Unicode-normalized, and lowercased before matching. The maximum is 64 UTF-8 bytes. Free has an allowance of zero and returns 409 route_limit_reached. Recognized non-Free plans have unlimited exact routes. Route status is suspended while the effective plan disallows routes. Stored suspended routes remain counted. Hosted test addresses are managed separately.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 429
- 503
Created
Invalid local part or endpoint identifier.
Missing, invalid or revoked credentials.
Required scope or account access missing.
Domain or endpoint not found in this account.
Exact route already exists or the account allowance is exhausted. For Free, code is route_limit_reached and limit is 0.
Shared client-IP or account request allowance exhausted. Retry after the indicated number of seconds. Browser authentication errors can use a different response format.
Response Headers
no-store
Seconds to wait before retrying.
Request limiting cannot be enforced. Retry later with backoff.
Response Headers
no-store