---
title: "Create Record"
method: POST
path: "/domains/{domain}/records"
---

# Create Record

`POST /domains/{domain}/records`

Creates a record for a domain.

## Path parameters

- `domain` string, required

## Request body

- object
  - `type` string, required — The type of record
  - `hostname` string, required — The subdomain for the record
  - `value` string, required — The value for the record, eg. IP address
  - `ttl` integer, required — The records time to live
  - `priority` integer — Priority of the record
  - `weight` integer — Weight of the record
  - `port` integer — The port the service is running on
  - `caaflag` integer — Flag for CAA records
  - `caatype` string — Type of CAA certificate to use

## Response `200`

200

- object
  - `id` string
  - `uid` string
  - `domain` string
  - `hostname` string
  - `type` string
  - `value` string
  - `priority` integer
  - `weight` integer
  - `port` integer
  - `caaflag` integer
  - `caatype` string
  - `ttl` integer

## Other responses

- `400` — 400

---

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