PayphonePayphone
Api reference

Bulk SMS (Own Line)

Send up to 100 SMS messages from your exclusive phone line. Free within monthly quota, $0.05/msg over quota. Requires Privy bearer.

Send up to 100 SMS messages from your exclusive phone line. Free within monthly quota, $0.05/msg over quota. Requires Privy bearer.

POST
/api/v1/sms/bulk

Authorization

x402 bearer
X-PAYMENT<token>

x402 payment header. When a request is sent without payment, the server returns 402 Payment Required with the price and payTo address. The caller signs an EIP-3009 transferWithAuthorization for USDC on Base and resubmits with the signed payment in this header. See https://docs.x402.org

In: header

AuthorizationBearer <token>

Privy access token (dashboard sessions, ~1h TTL) or long-lived dial_live_* / dial_test_* API key minted from /dashboard/billing. API keys are scope-gated per route (sms:send, numbers:read, account:read, etc.); Privy sessions bypass scope checks. See /docs/api-reference/api-keys for the full scope catalogue.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://payphone.wtf/api/v1/sms/bulk" \  -H "Content-Type: application/json" \  -d '{    "phoneNumber": "string",    "messages": [      {        "to": "string",        "message": "string"      }    ]  }'
{
  "success": true,
  "provider": "string",
  "from": "string",
  "totalQueued": 0,
  "totalBlocked": 0,
  "totalSuppressed": 0,
  "quotaUsed": 0,
  "paidCount": 0,
  "results": [
    {
      "to": "string",
      "messageId": "string",
      "status": "queued"
    }
  ]
}
{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "100000",
      "payTo": "string"
    }
  ]
}