---
title: "Add domain(s) to catalog"
method: POST
path: "/v1/domains"
---

# Add domain(s) to catalog

`POST /v1/domains`

## Request

- Base URL: `https://domaindrift.io`
- URL: `https://domaindrift.io/v1/domains`
- Auth: API key in header `X-DomainDrift-Key`

Add one or more domains (max 100 per request). Duplicates are NOT an error: they come back 200 with results[].status "exists". Per-domain outcomes: added, reactivated, exists, rejected.

## Request body

- object: Provide either `domain` (single) or `domains` (bulk, max 100).
  - `domain` string
  - `domains` string[]: Bulk add (max 100)
  - `category` string

## Response `200`

Nothing new added (every domain already exists or was rejected). Same body format as 201.

## Other responses

- `201`: At least one domain added or reactivated - scanned on the next sweep
- `400`: Missing domain(s) or more than 100 domains in one request

---

[API](https://skmtc.dev/domaindrift/apis/domaindrift-continuous-internet-telemetry-api.md) · [All operations](https://skmtc.dev/domaindrift/apis/domaindrift-continuous-internet-telemetry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domaindrift/apis/domaindrift-continuous-internet-telemetry-api/revisions/eb8e3f45736c?raw)