Overview

Swivell webhooks let you subscribe to events asynchronously. Below are examples of events you can receive alerts for:

• "Deposits into a proxy"
• "Payouts from a proxy landing in your wallet"

Categories

Webhook events are organized into categories that describe which resource changed. There are currently categories for: proxy, proxy_deposit, proxy_payout

Delivery

Webhook events are delivered as soon as they occur. Swivell makes a POST request to your url with a body containing the event payload. Payloads are signed using HMAC-SHA256. Continue here for details on how to verify the authenticity of a webhook call.

Retries

Once called, it is important to respond immediately with a 2xx and continue any processing offline to prevent timeouts. If Swivell encounters a timeout or non-2xx response, it will retry with an exponential backoff. Events not delivered after 3 days will auto-expire.

Multiple Deliveries

Swivell does its best to deliver events once. However, it is not impossible for multiple deliveries with the same payload to be made. Please do your best to handle redundant calls for the same event. Each payload comes with an event id that can be used to detect dupes.