Skip to content

Resend the holder verification e-mail

POST /api/v2/domains/{id}/email-verification/actions/resend

Sends the registry’s verification e-mail to the domain holder again. Call it when actions.canResend.allowed is true on GET /api/v2/domains/{id}/email-verification. The e-mail goes to verification.recipient. Opening the link in it confirms the address. The body is empty or {}. Returns the recipient and when the e-mail was sent.

Authentication: An API key with the scope write:domains. About keys and scopes

Request

Path parameters

idstringrequired
The domain ID. From GET /api/v2/domains.

Query parameters

langstring
Language of the verification e-mail. Default en. One of en, sv.

Example

POST /api/v2/domains/{id}/email-verification/actions/resend
curl -X POST "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/email-verification/actions/resend" \
-H "Authorization: Bearer $HOSTUP_API_KEY" \
-H "Content-Type: application/json"

Responses

200 The verification e-mail was sent.

Response 200
{
"ok": true,
"domain": {
"id": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3",
"name": "example.com"
},
"verification": {
"recipient": "user@example.com",
"method": "email"
},
"sentAt": "2026-04-27T12:00:00.000Z"
}
Response fields
okboolean
Always true.
domainobject
idstring
namestring
verificationobject
recipientstring
The address the e-mail was sent to.
methodstring
One of email.
sentAtstring
When the e-mail was sent.

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.
404Not found. The resource does not exist or is not owned by the caller; code is domain_not_found.
409No e-mail was sent. email_verification_not_required: nothing is pending for the domain. email_verification_recipient_unavailable: no recipient address is on file. email_verification_recipient_unreachable: the address is on a suspended domain. Change the domain holder’s e-mail address instead.
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.
502The registry did not accept the request. Try again later.