> ## Documentation Index
> Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Custom Domain

Creates a white-label custom domain for the specified team. The domain will be provisioned through Cloudflare and must point to the platform via a CNAME record.

<ParamField path="team" type="string" required>
  The UUID of the team.
</ParamField>

<ParamField body="hostname" type="string" required>
  The fully qualified hostname to use (e.g., `app.example.com`). Must be a valid hostname, maximum 255 characters. Cannot contain `plugchoice` or `volttime`, and cannot be an existing platform domain.
</ParamField>

## Response

<ResponseField name="id" type="integer">
  The numeric ID of the custom domain.
</ResponseField>

<ResponseField name="hostname" type="string">
  The registered hostname.
</ResponseField>

<ResponseField name="status" type="string">
  The current provisioning status of the domain.
</ResponseField>