---
title: "Create Active Organization Domain"
method: POST
path: "/v1/organizations/me/domains"
tags: ["organizations"]
---

# Create Active Organization Domain

`POST /v1/organizations/me/domains`

Claim an email domain for the caller's organization. Owners and admins only.

The claim lands unverified and does nothing until ``POST
/me/domains/{id}/verify`` finds the record in ``verification_record``
published at the domain's apex. A public email provider is refused outright,
and a domain another organization already claims answers 409 without saying
who holds it.

## Request body

- OrganizationDomainCreateRequest
  - `default_role` 'member' | 'viewer'
  - `domain` string, required
  - `enabled` boolean

## Response `201`

Successful Response

- OrganizationDomainPublic — A claim as its organization's admins see it. Carries ``verification_record`` (the whole string to publish) rather than the raw token: the admin never has a use for the token on its own, and one field that can be copied verbatim into a DNS panel is harder to get wrong than a prefix they must remember to prepend.
  - `created_at` string, date-time, required
  - `default_role` string
  - `domain` string, required
  - `enabled` boolean
  - `id` string, uuid, required
  - `organization_id` string, uuid, required
  - `proof_expires_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `verification_record` string, required
  - `verified_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-03** `16f47a68c4c2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mozilla-ai/apis/otari/changes/v1/organizations/me/domains/post.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc.dev/mozilla-ai/apis/otari/revisions/80c117c36f36?raw)