---
title: "Create a 2FA Verification"
method: POST
path: "/v1/two-fa/verification"
tags: ["2FA"]
---

# Create a 2FA Verification

`POST /v1/two-fa/verification`

Creates a 2FA verification and sends a one-time password (OTP) to the destination phone number over the selected channel. Requires a 2FA service configured in the Wavix portal; the service is reused to generate and validate OTPs.

The verification proceeds through three steps:
1. Create a verification to generate and send an OTP.
2. Resend the OTP on the same verification if needed.
3. Validate the OTP through the check endpoint.

## Request body

- TwoFactorVerificationCreateRequest
  - `service_id` string, required — Unique Wavix 2FA Service ID. Available on the Wavix portal.
  - `to` string, required — End user's phone number to which the verification code will be sent. The phone number must be in E.164 format.
  - `channel` string, required — Channel used to deliver the verification code. One of `sms` (sent as a text message) or `voice` (read aloud over a phone call).

## Response `200`

Returns the created 2FA verification.

- object
  - `success` boolean, required — Indicates whether the 2FA Verification was successfully created
  - `service_id` string, required — Unique identifier of the Wavix 2FA Service
  - `session_url` string, required — Automatically generated 2FA Verification URL. The URL can be used to resend or validate the OTP.
  - `session_id` string, required — Unique identifier of the Wavix 2FA Verification
  - `destination` string, required — The end user's phone number.
  - `created_at` string, date-time, required — Date and time the 2FA Verification is created
  - `number_lookup` PhoneLookupDetails, required
    - `number_type` string, required — The destination phone number type
    - `country` string, required — The destination phone number's 2-letter ISO country code
    - `current_carrier` string, required — The carrier name the phone number currently belongs to

## Other responses

- `400` — Request failed. Missing or invalid parameter <param_name>
- `403` — Request failed. The feature is disabled for your account.

---

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