Add a new domain to the organization for email verification purposes. Requires organization admin or manage permissions.
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": []
}
Session cookie authentication for production deployments. The session token is automatically set as an HTTP-only, secure cookie.
Organization ID
Domain added successfully
The response is of type object
.
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": []
}