---
title: "Add a custom domain to the project"
method: POST
path: "/projects/{id}/custom_domains"
tags: ["Notifications"]
---

# Add a custom domain to the project

`POST /projects/{id}/custom_domains`

## Request

- Base URL: `https://api.hookdeck.com/2025-07-01`
- URL: `https://api.hookdeck.com/2025-07-01/projects/{id}/custom_domains`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

## Path parameters

- `id` string, required: Project ID

## Request body

- AddCustomHostname
  - `hostname` string, required: The custom hostname to attach to the project

## Response `200`

Custom domain successfuly added

- AddCustomHostname
  - `hostname` string, required: The custom hostname to attach to the project

## Changes

- **2026-09-24** `9bebff6c68f9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/changes/projects/:id/custom_domains/post.md)

---

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