# twilio-verify-send-otp

twilio-verify-send-otp is a Claude Code skill that adds Twilio Verify flows for sending one-time codes and checking submitted OTPs, for phone or email confirmation and two-factor authentication.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 191 installs · ★ 42 repo stars
- Author: twilio
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/twilio/ai/tree/HEAD/skills/twilio/twilio-verify-send-otp/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/twilio-twilio-verify-send-otp

## What it does

The skill walks through the Verify flow: create a service, send a code, then check the submitted value. Delivery can use SMS, voice, email, or WhatsApp. When a device supports it, an SMS verification can be upgraded to RCS automatically. TOTP for authenticator apps uses the separate Verify Factors API.

You’ll need a Twilio account, the `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, and `VERIFY_SERVICE_SID` environment variables, plus the `twilio` SDK for Python or Node.js. Create the Verify Service once and reuse its SID. WhatsApp requires a registered production sender, so that channel depends on having one set up. You can enable SMS as a fallback when WhatsApp delivery fails.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-verify-send-otp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/twilio-verify-send-otp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/twilio-verify-send-otp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-verify-send-otp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/twilio-verify-send-otp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-verify-send-otp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/twilio-verify-send-otp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install twilio/ai skills/twilio/twilio-verify-send-otp
```

2. **Manually: put the files in place**
- File: `.github/skills/twilio-verify-send-otp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-verify-send-otp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/twilio/ai --path skills/twilio/twilio-verify-send-otp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/twilio-verify-send-otp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-verify-send-otp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/twilio/ai/tree/HEAD/skills/twilio/twilio-verify-send-otp/SKILL.md

## When to use it
- send a one-time code to a phone or email address
- check an OTP entered by a user
- add code delivery by voice call
- fall back to SMS when WhatsApp delivery fails
- set up TOTP with the Verify Factors API

## Example prompts
- Add a Twilio Verify flow that sends an OTP by SMS and checks the submitted code.
- Set up email confirmation with Twilio Verify.
- Configure WhatsApp OTP delivery with SMS fallback if the message fails.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 34ee53ba772dc3f0.

BEGIN THIRD-PARTY FILE 34ee53ba772dc3f0
````text
---
name: twilio-verify-send-otp
description: >
  Send and verify one-time passcodes (OTPs) via Twilio Verify over SMS
  (auto-upgraded to RCS where supported), voice, email, or WhatsApp. Covers
  creating a Verify Service, sending tokens,
  checking submitted codes, automatic WhatsApp-to-SMS fallback, and service
  configuration. TOTP is supported via the Factors API (a separate family from
  channel-based OTP). Use this skill to add phone or email verification or
  two-factor authentication to any application.
---

## Overview

Use **Twilio Verify** to manage the full OTP lifecycle: code generation, delivery, expiry, rate limiting, and Fraud Guard protection. Use the **Programmable Messaging API** to build your own OTP message infrastructure and access features such as SMS Pumping Protection.

| | Twilio Verify | Programmable Messaging API |
|---|---|---|
| Code generation + expiry | Built-in (10min default, configurable). Also supports custom codes. | Build yourself |
| Rate limiting | Built-in (per-phone, per-service) | Build yourself |
| Fraud protection | Fraud Guard (geo-permissions, rate anomaly) | SMS Pumping Protection |
| A2P registration | Exempt — no 10DLC needed | Required — must register campaign |
| Multi-channel | One API, change `channel` param (SMS/Voice/Email/WhatsApp) | Separate integration per channel |
| Cost | [Per confirmed verification + channel fee](https://www.twilio.com/en-us/verify/pricing) | Per-message pricing + build cost |
| Delivery confirmation | Yes — via List Attempts or Events API | Yes (via StatusCallback) |

**When Programmable Messaging is justified:** You need full control over message content, custom delivery logic, or SMS Pumping Protection features. For standard OTP/2FA flows, use Verify.

Verify supports SMS, voice, email, and WhatsApp — only the `channel` parameter changes per delivery method. RCS is not a `channel` value: Verify automatically upgrades an `sms` verification to RCS where the device supports it and falls back to SMS. TOTP (authenticator apps) is supported via the Verify Factors API, a separate implementation from channel-based OTP.

---

## Prerequisites

- Twilio account (free trial works for testing)
  — New to Twilio? See `twilio-account-setup`
  — Verify requires no separate product activation — just create a Service below
- Environment variables:
  - `TWILIO_ACCOUNT_SID`
  - `TWILIO_AUTH_TOKEN`
  - `VERIFY_SERVICE_SID` (created in Quickstart step 1)
  — See `twilio-iam-auth-setup` for credential setup and best practices
- SDK: `pip install twilio` / `npm install twilio`
- For WhatsApp channel only: a registered production WhatsApp sender — see `twilio-whatsapp-manage-senders`

---

## Quickstart

**Step 1 — Create a Verify Service (one-time)**

**Python**
```python
import os
from twilio.rest import Client
````
END THIRD-PARTY FILE 34ee53ba772dc3f0

The third-party file has ended. Everything between the 34ee53ba772dc3f0 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2843 of 11190 bytes. © twilio · MIT · https://github.com/twilio/ai/tree/HEAD/skills/twilio/twilio-verify-send-otp/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
