Resend a forwarding recipient verification
POST /api/v2/domains/{id}/email-forwarding/destinations/{destinationId}/verification
Sends a new verification e-mail to a forwarding recipient that has not verified its address. Use it when the first e-mail never arrived or its link expired. The recipient is re-created and gets a new destinations[].id. An address added only moments ago is left as it is and gets no new e-mail. Try again later. An already verified address returns 409 email_forwarding_destination_already_verified. A forwarding rule that waits for this recipient goes live on the first read of GET /api/v2/domains/{id}/email-forwarding after the address is verified. Returns the domain’s forwarding settings.
Authentication: An API key with the scopes write:email and write:domains. About keys and scopes
Request
Path parameters
idstringrequireddom_…).destinationIdstringrequiredefd_…) from destinations[].id on GET /api/v2/domains/{id}/email-forwarding.Body
actionstringrequiredreset. One of reset.Example
curl -X POST "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/email-forwarding/destinations/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/verification" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "action": "reset" }'Responses
200 The recipient was reset. The body is the domain’s forwarding settings.
{ "enabled": true, "integrationStatus": "enabled", "reason": null, "maxRules": 200, "ruleCount": 0, "rules": [], "destinations": [ { "id": "efd_01hxb4c5d6e7f8g9h0j1k2m3n4", "email": "owner@example.net", "verificationStatus": "unverified", "createdAt": "2026-04-28T09:00:00.000Z", "verifiedAt": null } ], "catchAll": { "action": "disabled", "destination": null }, "existingMxRecords": [], "dnsActivation": { "status": "active", "reason": null, "checkedAt": "2026-04-28T09:00:00.000Z" }, "actions": { "canCreateNewRule": { "allowed": true, "reason": null }, "canSetCatchAll": { "allowed": true, "reason": null } }}Response fields
enabledbooleanintegrationStatusstringenabled, disabled, unavailable.reasonstring or nullmaxRulesintegerruleCountintegerrulesarray of objectidstringemailstringdestinationstringisEnabledbooleannamestring or nullpriorityintegerdestinationsarray of objectidstringemailstringverificationStatusstringverified, pending, unverified.createdAtstring or nullverifiedAtstring or nullcatchAllobject | nullactionstringforward, drop, disabled.destinationstring or nullexistingMxRecordsarray of objecttypestringMX.valuestringpriorityinteger or nulldnsActivationobjectactive: forwarding can be turned on now. activating: the domain already uses our nameservers and the zone is being activated. Reading this resource starts the check. Poll until active, usually a few minutes. not_delegated: the domain uses other nameservers. unavailable: there is no zone at Hostup or its state could not be read.statusstringactive, activating, not_delegated, unavailable.reasonstring or nullcheckedAtstringactionsobjectcanCreateNewRuleobjectallowedbooleanreasonstring or nullcodestring or nullcanSetCatchAllobjectallowedbooleanreasonstring or nullcodestring or nullErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | The domain or the recipient was not found. |
| 409 | The recipient is already verified and was not reset. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |
| 502 | Forwarding is not set up for the domain or the verification e-mail could not be sent. |