---
title: "Add a new domain to brand"
method: POST
path: "/v1/workspaces/{brandId}/domains"
tags: ["domains"]
---

# Add a new domain to brand

`POST /v1/workspaces/{brandId}/domains`

## Request

- Base URL: `https://api.dispatchtickets.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dispatchtickets.com/v1/workspaces/{brandId}/domains`
- Auth: `session-token` (a scheme the document does not define)

## Path parameters

- `brandId` string, required

## Request body

- AddDomainDto
  - `domain` string, required: The domain to add (e.g., support.acme.com for inbound, acme.com for outbound)
  - `type` 'INBOUND' | 'OUTBOUND', required: The type of domain (INBOUND for receiving, OUTBOUND for sending)

## Response `201`

Domain added successfully

## Other responses

- `400`: Invalid domain or already in use
- `403`: Custom domains not available on current plan

---

[API](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api.md) · [All operations](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dispatchtickets/apis/dispatch-tickets-api/revisions/82fc25ab859b?raw)