---
title: "Create Domain"
method: POST
path: "/api/v1/domains"
tags: ["Domain"]
---

# Create Domain

`POST /api/v1/domains`

## Request

- Base URL: `https://your-subdomain.okta.com`
- URL: `https://your-subdomain.okta.com/api/v1/domains`
- Auth: API key in header `Authorization`

Creates your domain.

## Request body

- Domain
  - `certificateSourceType` 'MANUAL' | 'OKTA_MANAGED'
  - `dnsRecords` DNSRecord[]
    - `expiration` string
    - `fqdn` string
    - `recordType` 'TXT' | 'CNAME'
    - `values` string[]
  - `domain` string
  - `id` string
  - `publicCertificate` DomainCertificateMetadata
    - `expiration` string
    - `fingerprint` string
    - `subject` string
  - `validationStatus` 'NOT_STARTED' | 'IN_PROGRESS' | 'VERIFIED' | 'FAILED_TO_VERIFY' | 'DOMAIN_TAKEN' | 'COMPLETED'

## Response `200`

Success

- Domain
  - `certificateSourceType` 'MANUAL' | 'OKTA_MANAGED'
  - `dnsRecords` DNSRecord[]
    - `expiration` string
    - `fqdn` string
    - `recordType` 'TXT' | 'CNAME'
    - `values` string[]
  - `domain` string
  - `id` string
  - `publicCertificate` DomainCertificateMetadata
    - `expiration` string
    - `fingerprint` string
    - `subject` string
  - `validationStatus` 'NOT_STARTED' | 'IN_PROGRESS' | 'VERIFIED' | 'FAILED_TO_VERIFY' | 'DOMAIN_TAKEN' | 'COMPLETED'

---

[API](https://skmtc.dev/okta/apis/okta-api.md) - [All operations](https://skmtc.dev/okta/apis/okta-api/llms.txt) - [OpenAPI document](https://skmtc.dev/okta/apis/okta-api/revisions/7e5249c30571?raw)