PayphoneQuickstart — First SMS in 60 Seconds
Mint a dial_live_* key, install the Payphone Cursor plugin, and send your first SMS — or skip straight to curl.
Step 1 — Who are you?
Copy-paste for agents
Give your coding agent this one-liner:
Read https://payphone.wtf/skill.md and https://payphone.wtf/.well-known/dial-onboarding.json — wire SMS alerts with DIAL_API_KEY. Default pool send (one-way); buy a dedicated line only if SMS replies are required.Full agent path: Agent quickstart
Pool vs dedicated line
| Mode | API | Owned line? | Replies? |
|---|---|---|---|
| Pool send | POST /api/v1/sms/send | No — shared pool numbers | No |
| Owned line | POST /api/v1/numbers/mine/send | Yes — your leased E.164 | Yes |
Agents: omit DIAL_OWNED_LINE_E164 for pool. Set DIAL_OWNED_LINE_E164=+1YOUR_LINE only when sending from your leased number (matches dashboard From picker). Validate with GET /api/v1/numbers/mine — skip suspended/orphaned lines.
Recipes
GitHub Actions — SMS on deploy failure
- name: SMS alert on failure
if: failure()
env:
DIAL_API_URL: https://payphone.wtf
DIAL_API_KEY: ${{ secrets.DIAL_API_KEY }}
ALERT_PHONE: ${{ secrets.ALERT_PHONE_E164 }}
run: |
curl -sf -X POST "$DIAL_API_URL/api/v1/sms/send" \
-H "Authorization: Bearer $DIAL_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"to\":\"$ALERT_PHONE\",\"message\":\"Deploy failed: ${{ github.repository }}@${{ github.sha }}\"}"Add DIAL_API_KEY and ALERT_PHONE_E164 as repository secrets.
Cron check-in
0 9 * * * curl -sf -X POST https://payphone.wtf/api/v1/sms/send \
-H "Authorization: Bearer $DIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to":"+1…","message":"Cron OK"}'Reference
| Topic | Link |
|---|---|
| API keys & scopes | API Keys |
| Cursor integration | Cursor docs |
| MCP tools | Connect MCP |
| Full API (LLM) | llms-full.txt |
| x402 (no account) | Getting Started |
Delivery: POST /api/v1/sms/send (pool) returning 200 = queued, not delivered. Pool = outbound-only — no SMS replies. Check account history for pool sends; use inbox only with a dedicated line.
Markets: Pool SMS — DE, GB, CA, AU, FR, BR, MX, SA, AE, ZA. US pool on roadmap. Dedicated US lines via numbers/buy/us.