Skip to content

Save an EPP code for a transfer

POST /api/v2/domains/{id}/actions/update-epp

Save a new EPP code (transfer code) on a domain you are transferring to Hostup. This only saves the code. The state of the transfer is not checked, so a transfer that has already finished also accepts a code. To save it and try the transfer again in one call, send eppCode to POST /api/v2/domains/{id}/actions/retry-transfer instead. A domain that is not a transfer returns 409 domain_not_eligible.

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

Request

Path parameters

idstringrequired
The domain ID (dom_…).

Body

eppCodestringrequired
The EPP code from the domain’s current provider. At most 256 characters.

Example

POST /api/v2/domains/{id}/actions/update-epp
curl -X POST "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/update-epp" \
-H "Authorization: Bearer $HOSTUP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"eppCode": "Xk7#pQ2v-Lm9w"
}'

Responses

200 The code was saved.

Response 200
{
"domainId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3",
"eppCodePersisted": true,
"transferRetryReady": true,
"updatedAt": "2026-04-27T12:00:00.000Z"
}
Response fields
domainIdstring
The domain ID.
eppCodePersistedboolean
Always true: the code was saved.
transferRetryReadyboolean
Always true. It does not mean a retry is allowed now. Check transferStatus.actions.canRetryTransfer on GET /api/v2/domains/{id}/lifecycle before you retry.
updatedAtstring
When the code was saved.

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. With requiredScopes in the body, the API key lacks a scope. Without it, the account is not active. A domain on another account answers 404 domain_not_found, not 403.
404Not found. The resource does not exist or is not owned by the caller; code is domain_not_found.
409The domain is not a transfer (domain_not_eligible). Only a transfer has an EPP code to save.
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.
502Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists.