Skip to content

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

idstringrequired
The domain ID (dom_…).
destinationIdstringrequired
The recipient ID (efd_…) from destinations[].id on GET /api/v2/domains/{id}/email-forwarding.

Body

actionstringrequired
Always reset. One of reset.

Example

POST /api/v2/domains/{id}/email-forwarding/destinations/{destinationId}/verification
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.

Response 200
{
"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
enabledboolean
integrationStatusstring
One of enabled, disabled, unavailable.
reasonstring or null
maxRulesinteger
ruleCountinteger
rulesarray of object
idstring
emailstring
destinationstring
isEnabledboolean
namestring or null
priorityinteger
destinationsarray of object
idstring
emailstring
verificationStatusstring
One of verified, pending, unverified.
createdAtstring or null
verifiedAtstring or null
catchAllobject | null
actionstring
One of forward, drop, disabled.
destinationstring or null
existingMxRecordsarray of object
typestring
One of MX.
valuestring
priorityinteger or null
dnsActivationobject
Whether the domain’s DNS zone at Hostup is live. E-mail forwarding runs on it. active: 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.
statusstring
One of active, activating, not_delegated, unavailable.
reasonstring or null
Why the zone is not active, in plain words. Null when it is active.
checkedAtstring
actionsobject
canCreateNewRuleobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
canSetCatchAllobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404The domain or the recipient was not found.
409The recipient is already verified and was not reset.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.
502Forwarding is not set up for the domain or the verification e-mail could not be sent.