---
title: "Add Subdomain"
method: POST
path: "/domains/{domain_id}/subdomains"
---

# Add Subdomain

`POST /domains/{domain_id}/subdomains`

## Request

- Base URL: `https://app.aikido.dev/api/public/v1`
- URL: `https://app.aikido.dev/api/public/v1/domains/{domain_id}/subdomains`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.aikido.io/api/oauth/token` scopes: `domains:write`

Add a subdomain to a attack surface domain

## Path parameters

- `domain_id` integer, required

## Request body

- object
  - `subdomain_name` string, required: Subdomain part of the domain name. This should not include the domain name. eg. 'apidocs' for 'apidocs.aikido.dev'

## Response `200`

The subdomain has been added successfully

- object
  - `success` integer: The integer 1 indicating success

---

[API](https://skmtc.dev/aikido/apis/aikido-security-api-documentation.md) - [All operations](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/revisions/da8691338133?raw)