Webhook Payloads

Webhook bodies are JSON objects containing details about the events that occurred.

{
  "id": "ef229f27-e49a-4780-b2d9-e33a2c3fddcb",
  "timestamp": "2025-06-09T22:09:05.191553Z",
  "created_at": "2025-06-09T22:09:04.849307Z",
  "version": "v1",
  "event_type": "proxy_deposit.updated",
  "event_category": "proxy_deposit",
  "payload": {
    "deposit": {
      "amount": "0.000024935252607881",
      "id": "0x648107cab222eb893659692ca190ab8f25b2dfdcb153b22d0078fa59e689ba2d",
      "network": "arbitrum",
      "originators": [
        "0xc1303D311e8E74EE700848F56e05C945a406F55F"
      ],
      "payout_id": "p_ybmx2w57pigwhgc526hptf",
      "proxy_id": "test-proxy-2",
      "state": "forwarded",
      "time": "2025-06-04T22:07:11.534706Z",
      "token": "0x0000000000000000000000000000000000000000",
      "token_symbol": "ETH",
      "tx_hash": "0xfe6760b2ae3986611837cead1a8cf0bb84513224d2ab3116ec9df8bbf609cfa3",
      "value_usd": "0.065180851958357662066571311511"
    }
  }
}

Field Reference

Field	Type	Description
`id`	string	Unique identifier for the webhook event
`time`	string	ISO 8601 timestamp when the webhook request made.
`created_at`	string	ISO 8601 timestamp when the event was occurred
`version`	string	API version (e.g., "v1")
`event_type`	string	Event that occurred (e.g., "proxy_payout.completed")
`event_category`	string	Category of the event (e.g., "proxy_payout")
`payload`	object	Event-specific data payload

Event Types

event_type indicates the event that occurred. They are always in the format of: event_category.[change].

Here is a list of current event types.

Event Type	Category	Description
`proxy.created`	`proxy`	Triggered when a new proxy is created
`proxy_deposit.created`	`proxy_deposit`	Triggered when a new deposit is received by a proxy
`proxy_deposit.updated`	`proxy_deposit`	Triggered when a proxy deposit is updated (status changes, etc.)
`proxy_payout.created`	`proxy_payout`	Triggered when a new payout is initiated from a proxy
`proxy_payout.completed`	`proxy_payout`	Triggered when a proxy payout is successfully completed