{"uid":"cap_uEv--HRJU-Yf9jkGTxzzt","slug":"agent-dispatch-sms-c824cb45","name":"Agent Dispatch SMS","description":"Send one SMS to a mobile number, paid per message in USDC with x402. Use it when an agent must notify a person by text. The 402 quotes the exact price for the destination and message length. No account and no API key: any wallet that pays sends in one call. An opt-out link is appended to the message, and numbers that opted out are refused. Returns an order; poll GET /v1/orders/{id} for delivery status.","url":"https://agent-dispatch-production-4e75.up.railway.app/v1/sms?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","pattern":"^\\+[1-9][0-9]{7,14}$","description":"Recipient mobile number in E.164, for example +40700000000."},"body":{"type":"string","maxLength":4096,"minLength":1,"description":"Message text, sent as written."},"normalize":{"enum":["none","gsm"],"type":"string","description":"gsm turns typographic punctuation and Latin diacritics into GSM-7 equivalents so the text fits fewer segments. Default none."},"consent_reference":{"type":"string","maxLength":256,"minLength":1,"description":"Only with X-API-Key: the recorded consent reference for this recipient."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.056","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.056/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.056","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.056","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pq0zCUSRdksHZet0DJYE3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.056","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Send a single SMS message to a mobile number, paid per-message in USDC via x402, with no API key required.","exampleAgentPrompt":"Text +14155550198 to let them know their order has shipped — send 'Your package is on its way! Expected delivery: Thursday.' and normalize the text to GSM so it fits in one segment.","exampleUseCases":[{"title":"Agent alert on task completion","prompt":"Once the data pipeline finishes, text +12025550143 saying 'Your report is ready — log in to download it.' Use GSM normalization to keep it short."},{"title":"Two-factor style one-time notification","prompt":"Send a text to +447911123456 with the message 'Your verification code is 847291. Valid for 10 minutes.' — pay per message, no account needed."},{"title":"Customer order status update","prompt":"Text my customer at +33612345678 and tell them 'Your reservation is confirmed for Friday at 7pm. See you then!' — just send it now, I'll pay per message."}],"resultDescription":"Returns an order object containing an order ID. Delivery status is not immediate — the agent must poll GET /v1/orders/{id} to check whether the SMS was delivered, pending, or failed.","failureModes":["Recipient has opted out — number is refused and the message is not sent","Invalid E.164 phone number format — request rejected with validation error","Message body empty or exceeds 4096 characters — rejected","Insufficient USDC balance or failed x402 payment — message not sent","Destination number unreachable or carrier rejection — detectable via order status poll"],"whenToPreferThis":"Use this endpoint when an agent needs to send a single, immediate SMS notification to a known mobile number without setting up an account or API key — ideal for serverless, wallet-funded agent workflows using x402 micropayments. Prefer it over Twilio or similar when you want pay-per-message USDC settlement with zero onboarding friction. Not suitable for bulk sends or two-way conversational SMS.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:35:08.384Z","isFirstParty":false,"canonicalSlug":"agent-dispatch-sms-c824cb45"}