Skip to main content
POST
/
v3
/
teams
/
{team}
/
custom-domains
/
subdomain
Create Managed Subdomain
curl --request POST \
  --url https://app.plugchoice.com/api/v3/teams/{team}/custom-domains/subdomain \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "<string>"
}
'
{
  "id": 123,
  "hostname": "<string>",
  "status": "<string>"
}
Creates a managed subdomain under the platform’s shared domain for the specified team. Provide a single label and the platform appends its own base domain to produce the full hostname. The subdomain is provisioned through Cloudflare. An active partner subscription is required.
​
team
string
required
The UUID of the team.
​
label
string
required
The subdomain label to register. May contain lowercase letters, numbers, and hyphens, and cannot start or end with a hyphen (maximum 63 characters). The label is lowercased before validation. Reserved labels (such as www, app, api, admin, plugchoice, and volttime) are rejected, as are labels already in use.

​
Response

​
id
integer
The numeric ID of the custom domain.
​
hostname
string
The full hostname, composed of the label and the platform’s base domain.
​
status
string
The current provisioning status of the domain.