Skip to main content
POST
/
v3
/
teams
/
{team}
/
custom-domains
Create Custom Domain
curl --request POST \
  --url https://app.plugchoice.com/api/v3/teams/{team}/custom-domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "hostname": "<string>"
}
'
{
  "id": 123,
  "hostname": "<string>",
  "status": "<string>"
}
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.
team
string
required
The UUID of the team.
hostname
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.

Response

id
integer
The numeric ID of the custom domain.
hostname
string
The registered hostname.
status
string
The current provisioning status of the domain.