---
title: "Verify customer email address."
method: POST
path: "/auth/email-verify"
tags: ["Auth"]
---

# Verify customer email address.

`POST /auth/email-verify`

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.

## Request body

- RequestBodyAuthEmailVerifyPOST — Request body for POST /auth/email-verify (email verification).
  - `token` string, required — 64-character lowercase hexadecimal verification token. Sent to the customer's email after `POST /auth/signup`.

## Response `200`

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

- CustomerManagerEmailVerifyResult — Result of a successful email verification. Contains the verified customer.
  - `customer` CustomerManagerCustomer, required
    - `id` string, uuid — The unique identifier of the customer.
    - `name` string — Name of the customer.
    - `detail` string — Details about the customer.
    - `email` string, email — Email address of the customer.
    - `phone_number` string — Customer's contact phone number in E.164 format.
    - `address` string — Address of the customer.
    - `webhook_method` '' | 'POST' | 'GET' | 'PUT' | 'DELETE' — The HTTP method used for webhook (e.g., POST, GET, PUT, DELETE).
    - `webhook_uri` string — URI where webhook events are delivered.
    - `billing_account_id` string, uuid — The unique identifier of the customer's default billing account. Returned from the `GET /billing_accounts/{id}` response.
    - `metadata` CustomerManagerMetadata — Configuration flags for a customer account. Controls platform behavior such as RTP packet capture for debugging audio issues. Updatable by CustomerAdmin via `PUT /customer/metadata` or by ProjectSuperAdmin via `PUT /customers/{id}/metadata`.
      - `rtp_debug` boolean — When set to `true`, RTPEngine captures RTP traffic as PCAP files for this customer's calls. Use this to debug audio quality issues (one-way audio, codec problems, jitter). Default is `false`. Enabling this increases storage usage — disable after debugging.
    - `email_verified` boolean — Whether the customer's email has been verified.
    - `status` 'initial' | 'active' | 'frozen' | 'deleted' | 'expired' — Account lifecycle status.
    - `identity_verification_status` 'none' | 'pending' | 'verified' | 'rejected' — Customer's identity verification status. Determines access to PSTN number purchases and outbound PSTN calls.
    - `tm_deletion_scheduled` string, date-time — Timestamp when account deletion was requested. Null if not scheduled.
    - `tm_create` string, date-time — Timestamp when the customer was created.
    - `tm_update` string, date-time — Timestamp when the customer was last updated.
    - `tm_delete` string, date-time — Timestamp when the customer was deleted.

## Other responses

- `400` — Bad request. Possible causes: - Token is invalid, expired, or already used. - Request body is malformed JSON. - `token` field is missing.

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/versions/79e779080bcc/schema)