Domains

Create domain

Connect a supported customer-owned subdomain to a project.

POST/api/v1/projects/{projectID}/domains

Authentication: REST bearer token required.

Parameters

projectIDUUIDrequired

PathThe project UUID.

hostnamehostnamerequired

BodyThe lowercase customer-owned subdomain to connect.

Responses

201

The pending domain and its DNS instructions.

400

The request is invalid or contains an unsupported value.

401

The bearer token is missing, invalid, or expired.

403

The account plan or current grant does not allow the action.

404

The requested resource does not exist for this account.

409

The request conflicts with the current resource state.

503

The required provider or service is not configured or available.

cURL

curl --fail-with-body --request POST \
  --url "https://api.sitedropper.com/api/v1/projects/${PROJECT_ID}/domains" \
  --header "Authorization: Bearer $SITEDROPPER_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "hostname": "preview.example.com"
}'

Response · 201

{
  "id": "fd6035fd-0297-4a46-a88f-b691d6f8602f",
  "project_id": "8d7748aa-3e9d-44d5-85f9-928f20a19c62",
  "hostname": "preview.example.com",
  "status": "pending",
  "certificate_status": "pending",
  "cname_target": "domains.sitedropper.com",
  "created_at": "2026-08-20T22:32:00Z",
  "updated_at": "2026-08-20T22:32:00Z",
  "dns_instructions": [
    {
      "purpose": "routing",
      "action": "create",
      "type": "CNAME",
      "name": "preview",
      "value": "domains.sitedropper.com",
      "required": true
    }
  ]
}