---
title: "Set the registrant contact fields on the account"
method: PATCH
path: "/account"
tags: ["Account"]
---

# Set the registrant contact fields on the account

`PATCH /account`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/account`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Writes the ICANN registrant contact — the only external data
requirement in the whole product line. Domain registries reject a
registration outright when a contact field is blank, so
`POST /domains/register` refuses with `422
INCOMPLETE_REGISTRANT_DATA` *before* raising an invoice, and names the
blank fields in `details.missing_fields`. Those names are exactly the
keys this endpoint accepts: send them, then retry the registration.

Nothing else on the platform needs any of this. A customer who only
buys VPS or hosting never has to fill it in, which is the point of an
e-mail-less account — so do not collect these fields speculatively.

Only the allowlisted fields below are writable; anything else is
rejected with `400` rather than silently ignored. Saving also
propagates the contact to the registrar for domains the account
already holds, because registries require it to stay accurate.

`registrant_ready: true` in the response means a domain order would
now pass the gate.

## Request body

- object
  - `first_name` string: Given name of the registrant.
  - `last_name` string: Family name of the registrant.
  - `company` string: Optional company name.
  - `address1` string: Street address. Registries reject a blank one.
  - `address2` string: Optional second address line.
  - `city` string
  - `state` string: State, province or region.
  - `postcode` string: Zip / postal code.
  - `country` string: ISO 3166-1 alpha-2 country code.
  - `phone_number` string: International form.

## Response `200`

Fields saved

- object
  - `success` boolean
  - `data` object
    - `updated_fields` string[]
    - `registrant_ready` boolean: True once a domain order would pass the completeness gate.
    - `missing_fields` string[]: Still-blank required fields, if any.
    - `missing_labels` string[]
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `400`: A field outside the allowlist, or a value the validator rejected

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)