PayphonePayphone
Api reference

Configure inbound webhook

Set or clear the HTTPS webhook URL for an owned line. **Auth:** Privy JWT or API key with `numbers:read`.

Set or clear the HTTPS webhook URL for an owned line.

Auth: Privy JWT or API key with numbers:read.

PUT
/api/v1/numbers/mine/webhook

Authorization

bearer
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

curl -X PUT "https://payphone.wtf/api/v1/numbers/mine/webhook" \  -H "Content-Type: application/json" \  -d '{    "phoneNumber": "string"  }'
Empty
Empty
Empty
{
  "success": false,
  "error": "missing_scope",
  "required": "string",
  "scopes": [
    "string"
  ]
}