Skip to main content
POST
/
v3
/
teams
/
{team}
/
domains
Register Domain
curl --request POST \
  --url https://app.plugchoice.com/api/v3/teams/{team}/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "<string>"
}
'
{
  "id": 123,
  "domain": "<string>",
  "verification_token": "<string>",
  "dns_record_host": "<string>",
  "verified_at": "<string>",
  "created_at": "<string>",
  "expires_at": "<string>"
}
Registers a new domain for the specified team. After registration, a DNS TXT record must be created to verify ownership. A background verification job is automatically scheduled 15 minutes after registration.
​
team
string
required
The UUID of the team.
​
domain
string
required
The domain name to register (e.g., example.com). Must be a valid domain, maximum 255 characters. Cannot already be in use by another organization.

​
Response

​
id
integer
The numeric ID of the domain.
​
domain
string
The registered domain name.
​
verification_token
string
The token to use in the DNS TXT record for verification.
​
dns_record_host
string
The DNS record host where the TXT record should be created.
​
verified_at
string
ISO 8601 timestamp of when the domain was verified. null if not yet verified.
​
created_at
string
ISO 8601 timestamp of when the domain was registered.
​
expires_at
string
ISO 8601 timestamp of when the domain registration expires if not verified (30 days after creation).