---
title: "Create a custom domain"
method: POST
path: "/businesses/{id}/custom_domains"
tags: ["Custom domains"]
---

# Create a custom domain

`POST /businesses/{id}/custom_domains`

## Path parameters

- `id` string, required

## Request body

- object
  - `domain` string, required — The domain name

## Response `200`

The created `CustomDomain` object

- CustomDomain
  - `id` string, required — The ID of the custom domain
  - `business` string, required — The ID of the business
  - `domain` string, required — The domain name
  - `dns_records` object[], nullable, required — The DNS records for the domain
    - `name` string, nullable, required — The DNS record host
    - `type` string, nullable, required — The DNS record type
    - `value` string, nullable, required — The DNS record value
  - `created_at` string, required — The date and time the custom domain was created
  - `validated` boolean, required — Whether the domain is valid
  - `setup_completed_at` string, nullable, required — The date and time setup was completed
  - `setup_type` string, nullable, required — The type of setup (automatic or manual)

---

[API](https://skmtc.dev/pocketflows/apis/pocketflows-api.md) · [All operations](https://skmtc.dev/pocketflows/apis/pocketflows-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pocketflows/pocketflows-api/revisions/26723490b96f/schema)