---
title: "Create Domain"
method: POST
path: "/2/domains/accounts/{account}/create"
tags: ["Domain > Order"]
---

# Create Domain

`POST /2/domains/accounts/{account}/create`

Create a Domain using prepaid payment (documentation: <a href='https://developer.infomaniak.com/docs/api/order/domain/how'>https://developer.infomaniak.com/docs/api/order/domain/how</a>)

## Path parameters

- `account` string, required

## Request body

- object
  - `additional_fields` string[], nullable — All the additional fields required for the tld
  - `address` integer — The debitor address id, if not specified will use the account's default address
  - `amount_total_excl_tax` number, double, required — Amount expected from the client, if calculated price is not equal, request will fail
  - `domain` string, required — The domain name ordered
  - `registration_period` integer, required — The domain registration period
  - `contacts` object
    - `admin` integer, nullable — The contact id of the admin.
    - `billing` integer, nullable — The contact id of the billing.
    - `owner` integer, nullable — The contact id of the owner.
    - `tech` integer, nullable — The contact id of the tech.
  - `with_options` object
    - `dns_anycast` boolean, nullable — Enable the renewal warranty option (default: false)
    - `domain_privacy` boolean, nullable — Enable the domain privacy option (default: false)
    - `renewal_warranty` boolean, nullable — Enable the renewal warranty option (default: false)

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 6a791d9bApiDomainDomain
    - `id` integer, required — The domain unique identifier
    - `name` string, required — The domain name
    - `tld` string, required — The domain tld
    - `status` object[], nullable, required — EPP Status of the domain
    - `resale_status` 'authorized' | 'listed' | 'not_authorized' | 'sold', required — The status of the domain regarding resale
    - `is_premium` boolean, required — Is the domain premium
    - `created_at` integer, nullable, required — Creation timestamp of the domain
    - `expires_at` integer, nullable, required — Expiration timestamp of the domain
    - `options` object, required — The domain options
      - `dns_anycast` boolean, required — Is Fast Anycast option enabled
      - `renewal_warranty` boolean, nullable, required — Is Renewal Warranty option enabled
      - `domain_privacy` boolean, nullable, required — Is Domain Privacy option enabled
      - `dnssec` boolean, required — Is DNSSec option enabled
    - `contacts` object, required — The domain contacts
      - `owner` 6a791d9bApiDomainContact
        - `address_type` 'int' | 'loc', required — Type of address
        - `first_name` string, required — First name of the contact
        - `last_name` string, nullable, required — Last name of the contact
        - `company` string, required — Company name
        - `street1` string, required — Primary street address
        - `street2` string, required — Secondary street address
        - `street3` string, nullable, required — Additional street address
        - `postal_code` string, required — Postal code
        - `city` string, required — City name
        - `state` string, required — State or region
        - `country_code` string, required — Country code (ISO 3166-1 alpha-2)
        - `id` integer, required — Contact unique identifier
        - `type` 'Association' | 'Organization' | 'Other' | 'Person', required — Type of contact
        - `phone` string, required — Phone number of the contact
        - `fax` string, nullable, required — Fax number of the contact
        - `email` string, required — Email address of the contact
        - `is_validated` boolean, required — Whether the contact email has been verified
        - `validated_at` integer, required — Timestamp when the contact was validated
        - `created_at` integer, required — Timestamp when the contact was created
        - `pending_modification` 6a791d9bApiDomainContactModification
          - `contact_before` 6a791d9bApiDomainContact, required — recursive
          - `contact_after` 6a791d9bApiDomainContact, required — recursive
          - `is_validated` boolean, required — Whether the modification has been validated
          - `created_at` integer, required — Creation date of the modification
          - `associated_domains` 6a791d9bApiDomainContactAssociatedDomain[], required — Domains associated with this contact (capped preview, see associated_domains_count for the total)
            - `id` integer, required — Domain ID
            - `name` string, required — Domain name
            - `roles` object[], required — Contact roles for this domain
              - …
          - `associated_domains_count` integer, required — Total number of domains associated with this contact
        - `associated_domains` 6a791d9bApiDomainContactAssociatedDomain[] — Domains associated with this contact (capped preview, see associated_domains_count for the total)
          - `id` integer, required — Domain ID
          - `name` string, required — Domain name
          - `roles` object[], required — Contact roles for this domain
        - `associated_domains_count` integer — Total number of domains associated with this contact
      - `admin` 6a791d9bApiDomainContact
        - `address_type` 'int' | 'loc', required — Type of address
        - `first_name` string, required — First name of the contact
        - `last_name` string, nullable, required — Last name of the contact
        - `company` string, required — Company name
        - `street1` string, required — Primary street address
        - `street2` string, required — Secondary street address
        - `street3` string, nullable, required — Additional street address
        - `postal_code` string, required — Postal code
        - `city` string, required — City name
        - `state` string, required — State or region
        - `country_code` string, required — Country code (ISO 3166-1 alpha-2)
        - `id` integer, required — Contact unique identifier
        - `type` 'Association' | 'Organization' | 'Other' | 'Person', required — Type of contact
        - `phone` string, required — Phone number of the contact
        - `fax` string, nullable, required — Fax number of the contact
        - `email` string, required — Email address of the contact
        - `is_validated` boolean, required — Whether the contact email has been verified
        - `validated_at` integer, required — Timestamp when the contact was validated
        - `created_at` integer, required — Timestamp when the contact was created
        - `pending_modification` 6a791d9bApiDomainContactModification
          - `contact_before` 6a791d9bApiDomainContact, required — recursive
          - `contact_after` 6a791d9bApiDomainContact, required — recursive
          - `is_validated` boolean, required — Whether the modification has been validated
          - `created_at` integer, required — Creation date of the modification
          - `associated_domains` 6a791d9bApiDomainContactAssociatedDomain[], required — Domains associated with this contact (capped preview, see associated_domains_count for the total)
            - `id` integer, required — Domain ID
            - `name` string, required — Domain name
            - `roles` object[], required — Contact roles for this domain
              - …
          - `associated_domains_count` integer, required — Total number of domains associated with this contact
        - `associated_domains` 6a791d9bApiDomainContactAssociatedDomain[] — Domains associated with this contact (capped preview, see associated_domains_count for the total)
          - `id` integer, required — Domain ID
          - `name` string, required — Domain name
          - `roles` object[], required — Contact roles for this domain
        - `associated_domains_count` integer — Total number of domains associated with this contact
      - `tech` 6a791d9bApiDomainContact
        - `address_type` 'int' | 'loc', required — Type of address
        - `first_name` string, required — First name of the contact
        - `last_name` string, nullable, required — Last name of the contact
        - `company` string, required — Company name
        - `street1` string, required — Primary street address
        - `street2` string, required — Secondary street address
        - `street3` string, nullable, required — Additional street address
        - `postal_code` string, required — Postal code
        - `city` string, required — City name
        - `state` string, required — State or region
        - `country_code` string, required — Country code (ISO 3166-1 alpha-2)
        - `id` integer, required — Contact unique identifier
        - `type` 'Association' | 'Organization' | 'Other' | 'Person', required — Type of contact
        - `phone` string, required — Phone number of the contact
        - `fax` string, nullable, required — Fax number of the contact
        - `email` string, required — Email address of the contact
        - `is_validated` boolean, required — Whether the contact email has been verified
        - `validated_at` integer, required — Timestamp when the contact was validated
        - `created_at` integer, required — Timestamp when the contact was created
        - `pending_modification` 6a791d9bApiDomainContactModification
          - `contact_before` 6a791d9bApiDomainContact, required — recursive
          - `contact_after` 6a791d9bApiDomainContact, required — recursive
          - `is_validated` boolean, required — Whether the modification has been validated
          - `created_at` integer, required — Creation date of the modification
          - `associated_domains` 6a791d9bApiDomainContactAssociatedDomain[], required — Domains associated with this contact (capped preview, see associated_domains_count for the total)
            - `id` integer, required — Domain ID
            - `name` string, required — Domain name
            - `roles` object[], required — Contact roles for this domain
              - …
          - `associated_domains_count` integer, required — Total number of domains associated with this contact
        - `associated_domains` 6a791d9bApiDomainContactAssociatedDomain[] — Domains associated with this contact (capped preview, see associated_domains_count for the total)
          - `id` integer, required — Domain ID
          - `name` string, required — Domain name
          - `roles` object[], required — Contact roles for this domain
        - `associated_domains_count` integer — Total number of domains associated with this contact
      - `billing` 6a791d9bApiDomainContact
        - `address_type` 'int' | 'loc', required — Type of address
        - `first_name` string, required — First name of the contact
        - `last_name` string, nullable, required — Last name of the contact
        - `company` string, required — Company name
        - `street1` string, required — Primary street address
        - `street2` string, required — Secondary street address
        - `street3` string, nullable, required — Additional street address
        - `postal_code` string, required — Postal code
        - `city` string, required — City name
        - `state` string, required — State or region
        - `country_code` string, required — Country code (ISO 3166-1 alpha-2)
        - `id` integer, required — Contact unique identifier
        - `type` 'Association' | 'Organization' | 'Other' | 'Person', required — Type of contact
        - `phone` string, required — Phone number of the contact
        - `fax` string, nullable, required — Fax number of the contact
        - `email` string, required — Email address of the contact
        - `is_validated` boolean, required — Whether the contact email has been verified
        - `validated_at` integer, required — Timestamp when the contact was validated
        - `created_at` integer, required — Timestamp when the contact was created
        - `pending_modification` 6a791d9bApiDomainContactModification
          - `contact_before` 6a791d9bApiDomainContact, required — recursive
          - `contact_after` 6a791d9bApiDomainContact, required — recursive
          - `is_validated` boolean, required — Whether the modification has been validated
          - `created_at` integer, required — Creation date of the modification
          - `associated_domains` 6a791d9bApiDomainContactAssociatedDomain[], required — Domains associated with this contact (capped preview, see associated_domains_count for the total)
            - `id` integer, required — Domain ID
            - `name` string, required — Domain name
            - `roles` object[], required — Contact roles for this domain
              - …
          - `associated_domains_count` integer, required — Total number of domains associated with this contact
        - `associated_domains` 6a791d9bApiDomainContactAssociatedDomain[] — Domains associated with this contact (capped preview, see associated_domains_count for the total)
          - `id` integer, required — Domain ID
          - `name` string, required — Domain name
          - `roles` object[], required — Contact roles for this domain
        - `associated_domains_count` integer — Total number of domains associated with this contact

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)