{"uid":"cap_ZUyN2tN2mkis5d36lIEh3","slug":"oneshot-agent-sms-send-46fa06c9","name":"OneShot Agent SMS Send","description":"Tools, payments, and compute orchestration for autonomous AI agents.\n\n## Authentication\n\n- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).\n First call returns `402 Payment Required` with a quote; sign and resend the request\n with `Authorization: ` and `X-Quote-ID: `.\n- **`agentId`** — free read-only endpoints accept `X-Agent-ID: ` (0x… address).\n- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`\n (issued by `POST /v1/soul/register`).\n- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the\n `API-Version: 2026-01-30` header.\n\n## Async tools & polling\n\nMost tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll\n`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.\nA WebSocket fallback is available at `wss:///v1/requests/subscribe`.\n\n## Pricing\n\nSee [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full\ntable. Per-call costs for this environment, rendered from the same config the routes bill from:\n\n| Tool | Cost |\n|---|---|\n| Web search | $0.001 |\n| Web read | $0.002 |\n| Research | $0.01 |\n| Person enrichment | $0.005 |\n| Email verification | $0.001 |\n| Deep research (person) | $0.05 |\n| Social profiles | $0.50 |\n| Local business search | $0.01 |\n| Commerce search | $0.002 |\n| LinkedIn history sync | $0.02 per bounded run |\n| LinkedIn reply | $0.02 per message |\n| LinkedIn profile view | $0.01 per view |\n| LinkedIn post reaction | $0.01 per reaction |\n| Email send | quote-based; service fee from $0.005 per send |\n| SMS send | $0.0035 per segment per recipient |\n| Voice call | $0.35/minute + $5.00 number registration on the first call |\n| Browser task | quote-based; minimum $0.005 |\n| Website build | quote-based; from $1.00 |\n| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |\n\n## Error format\n\n`{ \"error\": \"\", \"message\": \"\", \"details\": }`.\nValidation errors include a `details` field with the failing field paths.","url":"https://win.oneshotagent.com/v1/tools/sms/send?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string"},"message":{"type":"string"}}},"responseSchema":{"type":"json","example":{"tool":"sms","status":"processing","receipt_id":"rcpt_uuid","request_id":"uuid"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-YtrlzXOhfbGezD0pkYXx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Send an SMS message to a specified phone number via the OneShot Agent platform, billed per-message via x402.","exampleAgentPrompt":"Send a text message to +1-415-555-0198 saying 'Your appointment is confirmed for tomorrow at 3pm — see you then!'","exampleUseCases":[{"title":"Appointment reminder via SMS","prompt":"Text +1-646-555-0172 and let them know their dental appointment is confirmed for this Thursday at 10am."},{"title":"Agent alert notification","prompt":"Send an SMS to +1-212-555-0190 saying 'Your order has shipped and will arrive by Friday — track it at the link in your email.'"},{"title":"Two-factor or verification nudge","prompt":"Send a text to +1-310-555-0134 with the message: 'Your verification code is 847291. It expires in 10 minutes.'"}],"resultDescription":"Returns a JSON object with a receipt_id (unique receipt UUID), request_id (async job UUID), tool name ('sms'), and status ('processing'). Because the endpoint returns 202 Accepted, the agent must poll GET /v1/requests/{request_id} with its X-Agent-ID header to confirm final delivery status.","failureModes":["Invalid or unformatted phone number in 'to' field — message not delivered","Missing or invalid x402 payment header — 402 Payment Required returned with quote","Message body too long or empty — rejected before dispatch","Recipient number is on a do-not-contact list — delivery fails silently or with error","Polling request_id not found or expired — 404 from status endpoint","Insufficient USDC balance or payment signature invalid — 402 or 401 returned"],"whenToPreferThis":"Use this endpoint when an AI agent needs to send a single, programmatic SMS to a known phone number and can handle x402 micropayment authentication. Prefer it over email when the recipient is more reliably reached by text, or when immediacy matters. It fits well within agentic workflows that already use OneShot's ecosystem (enrichment, email, browser automation) and need a complementary SMS leg. Not suited for bulk SMS blasts or carrier-grade high-volume messaging.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:45:02.729Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-sms-send-46fa06c9"}