Skip to main content
POST
/
organizations
/
{id}
/
domains
Add Organization Domain
curl --request POST \
  --url https://{deploymentHost}/organizations/{id}/domains \
  --header 'Content-Type: application/json' \
  --data '{
  "domain": "<string>"
}'
{
"status": 201,
"message": "",
"data": {
"domain": {
"id": "domain_123456789",
"domain": "newdomain.com",
"is_verified": false,
"verification_token": "wacht_verify_xyz789abc123",
"verified_at": null,
"created_at": "2024-01-15T19:30:00Z"
},
"verification_instructions": {
"dns_record": {
"type": "TXT",
"name": "_wacht_verification",
"value": "wacht_verify_xyz789abc123"
},
"instructions": "Add this TXT record to your DNS settings and then use the verify endpoint to complete verification."
}
},
"session": {
"signin_attempts": [],
"signins": [
{
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
],
"signup_attempts": [],
"active_signin": {
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
},
"errors": []
}

Authorizations

__session
string
cookie
required

Session cookie authentication for production deployments. The session token is automatically set as an HTTP-only, secure cookie.

Path Parameters

id
string
required

Organization ID

Body

application/json
domain
string
required

Domain name to add (e.g., acme.com)

Response

Domain added successfully

status
integer
required

HTTP status code

message
string
required

Response message (empty for success)

data
any
required

Response data (can be any type)

session
object
required
errors
object[]
required

Array of error objects (empty for success)