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

# Verify a domain

`POST /organization/{organization_id}/domains/{domain_id}/verify`

## Request

- Base URL: `https://api.aiven.io/v1`
- URL: `https://api.aiven.io/v1/organization/{organization_id}/domains/{domain_id}/verify`
- Auth: HTTP bearer and OAuth 2
  - Authorization code: `https://console.aiven.io/oauth/authorize`
  - Token URL: `https://api.aiven.io/v1/oauth2/token` scopes: `accounts:write`

Verifies a domain in an organization. If a user signs up to the Aiven platform with a verified domain, they are automatically added as managed users to the organization that has this domain verified.

## Path parameters

- `organization_id` string, required
- `domain_id` string, required

## Response `200`

Response

- OrganizationDomainVerifyResponse: OrganizationDomainVerifyResponse
  - `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.dev/aiven/apis/aiven-api-documentation.md) - [All operations](https://skmtc.dev/aiven/apis/aiven-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aiven/apis/aiven-api-documentation/revisions/562453405db0?raw)