---
title: "A new subdomain is added to the given domain."
method: POST
path: "/api/v2/companies/{id}/subdomains"
tags: ["Company Digital Footprint"]
---

# A new subdomain is added to the given domain.

`POST /api/v2/companies/{id}/subdomains`

A new subdomain is added to the given company's domain and a scan is triggered if it's classified as active. When Black Kite starts to monitor your companies, it scrapes all the related domains, which is called the digital footprint of that company. However, albeit rare, there are cases where you may want to relate a seemingly unrelated domain with your company, such as a side domain. Certain roles or permissions are needed to be able to use this endpoint. See the Extensions section of this endpoint or take a look at the 'Adding a Subdomain' article in the Black Kite help documents.

## Path parameters

- `id` integer, required

## Request body

- object
  - `Domain` string, required — The domain for which a subdomain wanted to be added.
  - `Subdomain` string, required — The subdomain to be added.

## Response `200`

Success

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `default` — Failure

---

[API](https://skmtc.net/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.net/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blackkitetech/black-kite-api/versions/7dadaba760fb/schema)