---
title: "[Beta] Activates a vanity subdomain for a project."
method: POST
path: "/v1/projects/{ref}/vanity-subdomain/activate"
tags: ["Domains"]
---

# [Beta] Activates a vanity subdomain for a project.

`POST /v1/projects/{ref}/vanity-subdomain/activate`

## Path parameters

- `ref` string, required

## Request body

- VanitySubdomainBody
  - `vanity_subdomain` string, required

## Response `201`

- ActivateVanitySubdomainResponse
  - `custom_domain` string, required

## Other responses

- `400` — This feature requires the Pro, Team, or Enterprise organization plan.
- `401` — Unauthorized
- `403` — Forbidden action
- `429` — Rate limit exceeded
- `500` — Failed to activate project vanity subdomain configuration

---

[API](https://skmtc.dev/supabase/apis/management-api.md) · [All operations](https://skmtc.dev/supabase/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supabase/management-api/revisions/a7cb39418064/schema)