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
idstringrequiredThe domain ID (
dom_…).Body
eppCodestringrequiredThe EPP code from the domain’s current provider. At most 256 characters.
Example
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.
{ "domainId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3", "eppCodePersisted": true, "transferRetryReady": true, "updatedAt": "2026-04-27T12:00:00.000Z"}Response fields
domainIdstringThe domain ID.
eppCodePersistedbooleanAlways true: the code was saved.
transferRetryReadybooleanAlways
true. It does not mean a retry is allowed now. Check transferStatus.actions.canRetryTransfer on GET /api/v2/domains/{id}/lifecycle before you retry.updatedAtstringWhen the code was saved.
Errors
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. 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. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is domain_not_found. |
| 409 | The domain is not a transfer (domain_not_eligible). Only a transfer has an EPP code to save. |
| 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 | Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists. |