---
title: "Create Pages domain"
method: POST
path: "/api/v4/projects/{id}/pages/domains"
tags: ["gitlab_pages"]
---

# Create Pages domain

`POST /api/v4/projects/{id}/pages/domains`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/pages/domains`
- Auth: none declared

Creates a Pages domain in a specified project. You must have permissions to create Pages domains.

## Path parameters

- `id` string, required

## Request body

- PostApiV4ProjectsIdPagesDomains: Create Pages domain
  - `domain` string, required: The domain
  - `certificate` string, binary: The certificate
  - `key` string, binary: The key
  - `auto_ssl_enabled` boolean: Enables automatic generation of SSL certificates issued by Let's Encrypt for custom domains.
  - `user_provided_certificate` string
  - `user_provided_key` string

## Response `201`

Create Pages domain

- APIEntitiesPagesDomain: API_Entities_PagesDomain model
  - `domain` string, required
  - `url` string, required
  - `verified` string, required
  - `verification_code` string, required
  - `enabled_until` string, required
  - `auto_ssl_enabled` string, required
  - `certificate` APIEntitiesPagesDomainCertificate
    - `subject` string, required
    - `expired` string, required
    - `certificate` string, required
    - `certificate_text` string, required

---

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