Organizations

Verify membership domain ownership

Verifies a pending domain using a 6-digit email verification code.

post/v2/organization/{organization}/membership-domains/{domainId}/verify

Request

Base URL: https://api.zephyr-cloud.io
URL: https://api.zephyr-cloud.io/v2/organization/{organization}/membership-domains/{domainId}/verify
Auth: HTTP bearer

Path parameters

organizationstring required

Organization unique name (URL-safe slug)

Example:zephyr-cloud

domainIdstring uuid required

Domain verification record ID

Example:550e8400-e29b-41d4-a716-446655440999

Request body

codestring required

6-digit verification code

Example request

{
  "code": "482915"
}

Response

Membership domain verification result

Example response

{
  "value": {
    "verified": true,
    "reason": "expired",
    "domain": {
      "id": "550e8400-e29b-41d4-a716-446655440123",
      "domain": "example.com",
      "emailDomain": "@example.com",
      "status": "pending",
      "verificationEmail": "it-admin@example.com",
      "role": "viewer",
      "codeExpiresAt": "2026-03-02T13:10:00.000Z",
      "lastSentAt": "2026-03-02T12:55:00.000Z",
      "sendCount": 2,
      "attemptCount": 1,
      "verifiedAt": "2026-03-02T13:00:00.000Z",
      "createdAt": "2026-03-02T12:55:00.000Z",
      "updatedAt": "2026-03-02T13:10:00.000Z"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.