LogoFreestyle
API Reference/Domains

Create a domain verification request

This creates a Freestyle Domain Verification Request. It returns a `verificationCode` for your domain. You need to place this code in a TXT record at `_freestyle_custom_hostname.thedomain.com`, then call the [verify domain](/#tag/domains/PUT/domains/v1/verifications) endpoint with the domain to verify it.

POST
/domains/v1/verifications

Request Body

application/jsonRequired
domainRequiredstring

The domain to create a verification code for

Response Body

200

Verification code created

idRequiredstring
Format: "uuid"
domainRequiredstring
accountIdRequiredstring
Format: "uuid"
verificationCodeRequiredstring
createdAtRequiredstring
Format: "date-time"

400

Failed to create verification code

messageRequiredstring
curl -X POST "https://api.freestyle.sh/domains/v1/verifications" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com"
  }'

Verification code created

{
  "id": "1234-5678-9012-3456",
  "domain": "example.com",
  "accountId": "1234-5678-9012-3456",
  "verificationCode": "freestyle-verification-v1-1234-5678-9012-3456",
  "createdAt": "1234567890"
}

List DNS Records GET

Previous Page

Remove Domain Mapping DELETE

Next Page

Freestyle AI

Documentation assistant

Experimental: AI responses may not always be accurate—please verify important details with the official documentation.

How can I help?

Ask me about Freestyle while you browse the docs.