You can add webhooks via the Seam Dashboard or programmatically. Let's start by looking at how to add and test a webhook via the dashboard.
Press "Add Webhook" to create a webhook for your device events
You can specify any public URL endpoint to receive webhook events by pasting the URL into the "Add Webhook" dialog.
You can specify any internet-accessible URL for your webhook URL
Webhook endpoints can receive many different types of events such as
device.low_battery. It's a good idea when getting started with webhooks to review the list of webhook event types and test your endpoint using the sandbox environment.
The sandbox environment allows you to test sending requests to an endpoint.
Seam delivers each webhook event based on a retry schedule with exponential backoff. Each message is attempted based on the following schedule, where each period is started following the failure of the preceding attempt.
- 5 seconds
- 5 minutes
- 30 minutes
- 2 hours
- 5 hours
- 10 hours
- 10 hours (in addition to the previous)
For example, an attempt that fails three times before eventually succeeding will be delivered roughly 35 minutes and 5 seconds following the first attempt.
If you remove or disable a webhook, delivery attempts to the endpoint will be disabled as well.