# Register a domain

If a domain is available, use this route to register it to your account. The domain will be minted or transfered to your custodial wallet where only Unstoppable Domains, on your behalf, will be able to make changes to it.

The price of the domain will be automatically added to your running balance with Unstoppable Domains. The pending balance of your account will be invoiced periodically.

### Register to specific owner
If you do not provide an owner in your request, your account's default wallet address will be used as the owner. Use GET /account to confirm your default wallet address.

When providing an owner object in your request, be sure the type aligns with the address. To register to one of your own wallets, the type must be SELF. Use GET /account/wallets to see your list of available wallets.

Endpoint: POST /domains
Version: 3.0.0
Security: bearer

## Query parameters:

  - `$preview` (boolean)
    Allows simulating the operation creation (when set to true), without actually starting any processing. This can be used to validate the operation will be permitted and get a preview of the initial outcome.

When used, the operation in the response will have PREVIEW for all id and status values.

## Request fields (application/json):

  - `name` (string, required)

  - `records` (object)

  - `owner` (object)

  - `owner.type` (string, required)
    Enum: "NONE", "UD", "SELF", "EXTERNAL"

  - `owner.address` (string, required)

## Response 201 fields (application/json):

  - `@type` (string, required)
    Enum: "unstoppabledomains.com/partner.v3.DomainOperationResult"

  - `operation` (object, required)

  - `operation.id` (string, required)
    Example: "op-4abb409c-9283-4589-bd36-d27a757a2165"

  - `operation.status` (string, required)
    Enum: "QUEUED", "SIGNATURE_REQUIRED", "PROCESSING", "COMPLETED", "FAILED", "CANCELLED"

  - `operation.type` (string, required)
    Enum: "DOMAIN_CLAIM", "DOMAIN_UPDATE", "DOMAIN_RETURN", "WALLET_CREATE", "WALLET_UPDATE", "WALLET_VERIFY", "ACCOUNT_UPDATE"

  - `operation.domain` (string)

  - `operation.lastUpdatedTimestamp` (number, required)
    Example: 1684356429790

  - `operation.dependencies` (array, required)