---
title: "Send a Viber Verification Message (OTP)"
method: POST
path: "/viber/otp"
---

# Send a Viber Verification Message (OTP)

`POST /viber/otp`

After authentication, you can make a request to the Viber OTP endpoint to send an OTP.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- object
  - `senderInfoTrackingId` string, required — Unique identifier of the Viber sender (from your sender configuration). Used for routing and tracking
  - `to` string[] — Recipient phone number in **E.164** format (e.g. `+306912345678`). Must include `+` and country code
  - `ttl` integer — Time-to-live in **seconds** for the OTP delivery attempt
  - `seq` string — Your own sequence or correlation ID for this request (e.g. for linking request and response or callbacks)
  - `label` string — Message label. Allowed values: `transactional`, `promotional`
  - `type` string — OTP message type. Allowed values: `PRIMARY_ONLY`, `ALL_DEVICE`
  - `templateId` string — ID of the OTP template to use. See [Templates inventory](https://docs.routee.net/docs/templates-inventory)
  - `templateLang` string — Language of the template (ISO 639-1, e.g. `en`, `el`). See [Localization](https://docs.routee.net/docs/localization)
  - `templateParams` object — Key-value map of template variables. Keys in **camelCase** (e.g. `pin`, `businessPlatformName`, `codeValidityTime`). See [Template variables validation](https://docs.routee.net/docs/template-variables-validations)

## Response `200`

200

- object
  - `trackingId` string
  - `to` string
  - `from` string
  - `country` string
  - `status` object
    - `status` string
    - `date` string
  - `applicationName` string
  - `direction` string
  - `ttl` integer
  - `seq` integer
  - `label` string
  - `type` string
  - `templateId` string
  - `templateParams` object
    - `pin` string
  - `templateLang` string

## Other responses

- `400` — 400

---

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