← All tutorialsAuth

SMS 2FA fallback

When email 2FA bounces, fall through to SMS. Read inbound replies via sms.read for verification round-trips.

Cost~$0.008 per send
Operations
sms.sendsms.read

Prerequisites

  • Twilio number provisioned and webhook URL pointed at your handler.
  • sms.send + sms.read enabled on the agent.

Walkthrough

1. Send the code

Generate the OTP server-side; never let the LLM see it.

bash# Send the 6-digit OTP. Generate it in your code, not the LLM.
curl -X POST https://www.upivia.com/v1/service-requests \
  -H "Authorization: Bearer $AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service":"sms",
    "operation":"send",
    "payload":{"to":"+15555550123","from":"+15555550000","body":"Code: 482193"}
  }'

2. Read inbound replies

Poll sms.read (or take the Twilio webhook) to confirm the user echoed the code back, if your flow needs round-trip verification.

Next steps

Audit every call at /audit-logs, watch spend at /usage, and tune budgets per service on the agent's page.

Create an account →