Webhooks Introduction

Webhooks let you get real-time notifications on events happening on your sessions — rotations, blocks, expirations, and more — without polling the API.

Event types

Payload format

Every webhook delivers a JSON payload with the event type, timestamp, and session data:

{
  "event": "session.rotated",
  "timestamp": "2026-07-06T18:22:00Z",
  "data": {
    "session_id": "sess_9f2a1c",
    "endpoint": "us.buyproxy.org:7000",
    "ip": "203.0.113.42"
  }
}

Verifying signatures

Each request includes an X-BuyProxy-Signature header. Verify it against your webhook secret to confirm the payload came from BuyProxy.

X-BuyProxy-Signature: sha256=5d41402abc4b2a76...