---
title: "Create a domain"
method: POST
path: "/organization/{organization_id}/domains"
tags: ["Domains"]
---

# Create a domain

`POST /organization/{organization_id}/domains`

Creates a new domain in an organization.

## Path parameters

- `organization_id` string, required

## Request body

- OrganizationDomainAddRequestBody — OrganizationDomainAddRequestBody
  - `domain_name` string, required — Name of the domain to be added
  - `verification_type` 'dns' | 'http' — An enumeration.

## Response `200`

Response

- OrganizationDomainAddResponse — OrganizationDomainAddResponse
  - `challenge_token` string, required — Random string to be used for validation
  - `create_time` string, required — Time of creating the domain
  - `domain_id` string, required — ID of the domain
  - `domain_name` string, required — Name of the domain
  - `linked_authentication_method_ids` string[], required — Linked Authentication Method Ids
  - `organization_id` string, required — ID of the organization owning this domain
  - `state` 'deleted' | 'unverified' | 'verified', required — An enumeration.
  - `verification_type` 'dns' | 'http', required — An enumeration.

---

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