---
title: "Add an allowed embed domain"
method: POST
path: "/v1/webchat/widgets/{widget_id}/domains"
tags: ["webchat"]
---

# Add an allowed embed domain

`POST /v1/webchat/widgets/{widget_id}/domains`

## Path parameters

- `widget_id` string, uuid, required

## Request body

- DomainCreate
  - `hostname` string, required
  - `include_subdomains` boolean

## Response `201`

Successful Response

- DomainResponse
  - `id` string, uuid, required
  - `hostname` string, required
  - `include_subdomains` boolean, required
  - `verification_state` string, required
  - `verification_token` string, required
  - `verified_at` string, date-time, nullable, required
  - `last_checked_at` string, date-time, nullable, required
  - `failure_reason` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/revisions/9cd7291d4228/schema)