# Agent Dispatch SMS

> Agent Dispatch SMS is a paid API for AI agents from agent-dispatch-production-4e75.up.railway.app, paid per call via x402, $0.056/call, status unknown (last checked 2026-10-12).

Send a single SMS message to a mobile number, paid per-message in USDC via x402, with no API key required.

## Facts

- Endpoint: POST https://agent-dispatch-production-4e75.up.railway.app/v1/sms?utm_source=zero.xyz
- Price: $0.056/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-dispatch-sms-c824cb45
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uEv--HRJU-Yf9jkGTxzzt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-dispatch-sms-c824cb45 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-dispatch-sms-c824cb45/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-dispatch-production-4e75.up.railway.app](https://www.zero.xyz/host/agent-dispatch-production-4e75.up.railway.app/llms.txt)