Sign in
Auth

Verify customer email address.

Validates the email verification token sent to the customer's email during signup. On success, the customer's email is marked as verified and an access key is provisioned.

The token is a 64-character lowercase hexadecimal string included in the verification email.

post/auth/email-verify

Request body

tokenstring required

64-character lowercase hexadecimal verification token. Sent to the customer's email after POST /auth/signup.

Example request

{
  "token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6abcd"
}

Response

Email verified successfully. Returns the customer and a provisioned access key.

Example response

{
  "customer": {
    "id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
    "name": "Acme Corporation",
    "detail": "Enterprise customer account",
    "email": "admin@acme.com",
    "phone_number": "+14155551234",
    "address": "123 Main St, San Francisco, CA 94105",
    "webhook_method": "POST",
    "webhook_uri": "https://api.acme.com/webhooks/voipbin",
    "billing_account_id": "b8c9d0e1-f2a3-4567-8901-23456789abcd",
    "metadata": {
      "rtp_debug": true
    },
    "email_verified": true,
    "status": "active",
    "identity_verification_status": "none",
    "tm_deletion_scheduled": "2026-01-15T09:30:00.000000Z",
    "tm_create": "2026-01-15T09:30:00.000000Z",
    "tm_update": "2026-01-15T09:30:00.000000Z",
    "tm_delete": "2026-01-15T09:30:00.000000Z"
  }
}

Changes

Changed in 1 of the 54 revisions of this API.2

  • 79e779080bcc2See the full diff
    • ●

      added the new expired enum value to the customer/status response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new initial enum value to the customer/status response property for the response status 200

      response-property-enum-value-added