Auth

Verify customer email address.

Changed on

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

  • Base URL
    https://api.voipbin.net/v1.0
  • URL
    https://api.voipbin.net/v1.0/auth/email-verify
  • Auth
    none declared

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

  • 79e779080bccRevision changes
    • warning

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

    • warning

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