---
title: "Create domain"
method: POST
path: "/orgs/domains"
tags: ["Workspace"]
---

# Create domain

`POST /orgs/domains`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/domains`
- Auth: HTTP bearer

Add a new domain to an org.

## Request body

- CreateDomainSchema: Schema for creating a new domain
  - `hostname` string, required: The domain string (e.g., example.com)

## Response `200`

- DomainSchema: Detailed information about an org domain
  - `id` string, required: Unique identifier for the domain
  - `hostname` string, required: The hostname string (e.g., example.com)
  - `org_id` string, required: Identifier of the org that owns this domain
  - `verified` boolean, required: Whether the domain is verified
  - `verified_at` string, date-time, nullable, required: Timestamp when the domain was verified
  - `created_at` string, date-time, nullable, required: Timestamp when the domain was created
  - `updated_at` string, date-time, nullable, required: Timestamp when the domain was last updated

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)
