---
title: "Add domain"
method: POST
path: "/api/v1/site/domains"
tags: ["Site"]
---

# Add domain

`POST /api/v1/site/domains`

## Request

- Base URL: `https://yespo.io` (the document declares no server; this is the origin it was published from)
- URL: `https://yespo.io/api/v1/site/domains`
- Auth: HTTP basic

The method registers the domain sent in the body params for use in web tracking or widgets.<br>Only one domain can be registered per organization.

## Request body

- DomainCreationRequest: DomainCreationRequest
  - `domain` string, required: Domain name

## Response `200`

OK<br>Domain already exists

## Other responses

- `201`: Created<br>Domain created
- `400`: Bad request<br>Invalid domain name
- `404`: Not found

---

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