---
title: "POST /v1/domains"
method: POST
path: "/v1/domains"
tags: ["Domains"]
---

# POST /v1/domains

`POST /v1/domains`

Reserve a domain

## Request body

- Domain
  - `id` string
  - `created` integer
  - `updated` integer
  - `domain` string — Name of the domain to reserve, for example joe.hooks.webhookrelay.com, hooks.example.com, tunnel.mydomain.com, etc.

## Response `201`

Created

- Response
  - `id` string — ID of the object
  - `status` string — Status of the action

## Other responses

- `400` — Invalid request
- `412` — Domain already taken
- `451` — Your subscription doesn't include domain reservations
- `500` — Internal server error

---

[API](https://skmtc.dev/webhookrelay/apis/webhook-relay.md) · [All operations](https://skmtc.dev/webhookrelay/apis/webhook-relay/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webhookrelay/webhook-relay/revisions/ce8fd4d3cf19/schema)