PaybytokenDocs
Webhooks
API reference · Webhook Endpoints

Retrieve a Webhook Endpoint

Retrieve a webhook destination and its event subscriptions.

GET /api/v1/webhook_endpoints/:id

curl https://api-prod.paybytoken.io/api/v1/webhook_endpoints/we_1ZbSVMF8KXuhmXpKPXkt \
  -H "Authorization: Bearer $PAYBYTOKEN_SECRET_KEY"
{
  "id": "we_1ZbSVMF8KXuhmXpKPXkt",
  "account_id": "acct_merchant",
  "url": "https://shop.example.com/webhooks/paybytoken",
  "enabled_events": ["payment_intent.succeeded"],
  "enabled": true,
  "previous_secret_expires_at": null,
  "secret_rotated_at": null,
  "created_at": "2026-07-29T09:30:00.000Z",
  "updated_at": "2026-07-29T09:30:00.000Z"
}

The signing secret is not returned. Rotate the secret if the creation value is lost. During an active rotation overlap, previous_secret_expires_at tells the receiver how long it must continue accepting signatures from the previous secret.

API Workbench

Full Explorer

Open in new tab