---
title: "Register a domain"
method: POST
path: "/{account}/registrar/domains/{domain}/registrations"
tags: ["registrar"]
---

# Register a domain

`POST /{account}/registrar/domains/{domain}/registrations`

Registers a domain name.

Your account must be active for this command to complete successfully. You will be automatically charged the registration fee upon successful registration, so please be careful with this command.

When registering a domain using Solo or Teams subscription, the DNS services
for the zone will be automatically enabled and this will be charged on your
following subscription renewal invoices.

## Path parameters

- `account` integer, required
- `domain` string, required

## Request body

- object
  - `registrant_id` integer, required — The ID of an existing contact in your account.
  - `whois_privacy` boolean — Set to true will attempt to purchase/enable the whois privacy as part of the registration. An extra cost may apply. Default: false.
  - `auto_renew` boolean — Set to true to enable the auto-renewal of the domain. Default: false.
  - `trustee` boolean — Set to true will attempt to purchase/enable trustee service as part of the registration. An extra cost may apply. Default: false.
  - `extended_attributes` object — Required for TLDs that require extended attributes.
  - `premium_price` string — Required as confirmation of the price, only if the domain is premium.
  - `linked_provider` string — The nickname of a linked provider to register the domain through. If left blank, registration will go through DNSimple.

## Response `201`

Domain successfully registered

- object
  - `data` DomainRegistration, required
    - `id` integer, required
    - `domain_id` integer, required
    - `registrant_id` integer, required
    - `period` integer, required
    - `state` 'cancelled' | 'new' | 'registering' | 'registered' | 'failed', required
    - `auto_renew` boolean, required
    - `whois_privacy` boolean, required
    - `trustee` boolean, required
    - `created_at` string, date-time, required — A date-time value, representing when the entry was created, formatted as ISO 8601.
    - `updated_at` string, date-time, required — A date-time value, representing when the entry was last updated, formatted as ISO 8601.

## Other responses

- `400` — A required parameter is missing or the request is invalid.

## Changes

- **2026-04-28** (v2) `53dd09c3a139` — 1 breaking, 1 warning, 2 info
  - removed the required property `data/trustee_service` from the response with the `201` status
  - removed the request property `trustee_service`
  - added the new optional request property `trustee`
  - added the required property `data/trustee` to the response with the `201` status
- **2026-03-19** (v2) `8f6934d1a399` — 2 info
  - added the new optional request property `trustee_service`
  - added the required property `data/trustee_service` to the response with the `201` status
- **2025-07-11** (v2) `06780be0ef17` — 1 breaking, 12 info
  - the request property `registrant_id` became required
  - the response property `data` became required for the status `201`
  - the response property `data/auto_renew` became required for the status `201`
  - the response property `data/created_at` became required for the status `201`
  - …9 more
- **2023-10-02** (v2) `537f134539d0` — 1 info
  - added the new optional request property `linked_provider`
- **2023-07-18** (v2) `c8591dcf8c29` — 13 breaking, 2 warning, 1 info
  - the response property `data` became optional for the status `201`
  - the response property `data/auto_renew` became optional for the status `201`
  - the response property `data/created_at` became optional for the status `201`
  - the response property `data/domain_id` became optional for the status `201`
  - …12 more

[Change history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/:account/registrar/domains/:domain/registrations/post.md)

---

[API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.dev/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dnsimple/apis/dnsimple-api/revisions/faec8b49cc03?raw)