> ## 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.

# Register Domain

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. Requires a verified email.

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

<ParamField body="domain" type="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.
</ParamField>

## Response

<ResponseField name="id" type="string">
  The UUID of the domain.
</ResponseField>

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

<ResponseField name="verification_token" type="string">
  The token to use in the DNS TXT record for verification.
</ResponseField>

<ResponseField name="dns_record_host" type="string">
  The DNS record host where the TXT record should be created.
</ResponseField>

<ResponseField name="verified_at" type="string">
  ISO 8601 timestamp of when the domain was verified. `null` if not yet verified.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the domain was registered.
</ResponseField>

<ResponseField name="expires_at" type="string">
  ISO 8601 timestamp of when the domain registration expires if not verified (30 days after creation).
</ResponseField>
