---
title: "OTP Auth Request"
method: POST
path: "/streams/otp/auth"
tags: ["Streams Service"]
---

# OTP Auth Request

`POST /streams/otp/auth`

Send a one-time password (OTP) to a recipient. TextPeak generates the code, delivers it using the stream's configured OTP template and channel, and returns a `request_uuid` you reference when verifying.

- Fails with `402` if the account balance is depleted, or `429` if the recipient's OTP request cap is reached.
- Use `retry: true` to resend to the same recipient.

**Authentication:** stream token in the `Authorization` header (see **Authentication** in the API Overview).

## Request body

- object
  - `recipient_phone` string, required — Recipient phone number in international format, digits only.
  - `event` string — Optional. The event/template to send the OTP with. Provide it only to override the default OTP template configured for this channel.
  - `template_variables` object — Optional. Values for any additional placeholders in the template beyond the built-in `[code]` placeholder. Keys are the placeholder names.
  - `retry` boolean — Set to `true` to resend the OTP to the same recipient.

## Response `200`

The OTP was accepted for delivery.

- object
  - `status` boolean — Whether the OTP was accepted for sending.
  - `request_uuid` string — Identifier for this OTP request; pass the code to the verify endpoint to complete it.
  - `code` string — Returned only when the stream is configured to expose the OTP code in the response.

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/versions/eacecf960bb6/schema)