---
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.

---

[API](https://skmtc.net/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.net/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dnsimple/dnsimple-api/revisions/270bb4f6f532/schema)