---
title: "Creates a new domain"
method: POST
path: "/domains"
tags: ["ProjectDomain"]
---

# Creates a new domain

`POST /domains`

Use this endpoint to create a new domain in your project. Once the domain is created,
[it can be found in the manager](https://redirection.io/manager).

💡 Read the [documentation about how to configure a domain on the redirection.io managed instances](https://redirection.io/documentation/managed-instances/add-a-domain-to-your-project).

## Request body

- ProjectDomainCreateJson
  - `backendAddress` string, nullable — The address of this backend, if there is one.
  - `backendAllowInvalidCertificate` boolean
  - `backendEnabled` boolean
  - `backendUseSsl` boolean
  - `domain` string, required
  - `project` string, iri-reference, required — An IRI reference to the project, of the form `/projects/{project_id}`.
  - `sslAutomatic` boolean
  - `sslEnabled` boolean

## Response `201`

ProjectDomain resource created

- ProjectDomainJson
  - `backendAddress` string, nullable, required — The address of this backend, if there is one.
  - `backendAllowInvalidCertificate` boolean, required
  - `backendEnabled` boolean, required
  - `backendUseSsl` boolean, required
  - `dnsValid` boolean, required
  - `domain` string, required
  - `id` string, required
  - `records` ProjectDomainProjectDomainRecordJson[], required
    - `detectedValue` string, required
    - `isValid` boolean, required
    - `name` string, required
    - `requiredValue` string, required
    - `type` string, required
  - `sslAutomatic` boolean, required
  - `sslEnabled` boolean, required

## Other responses

- `400` — Invalid input
- `403` — Forbidden
- `422` — An error occurred

---

[API](https://skmtc.net/redirection/apis/redirection-io.md) · [All operations](https://skmtc.net/redirection/apis/redirection-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/redirection/redirection-io/versions/50d19e1f364a/schema)