Setting up Wonderment's Webhooks

Webhooks are available on all paid plans

Webhooks are a popular way to access event data as it happens. You can use Wonderment's webhooks to send tracking data to your other tools, such as Zapier, Slack or your Data Warehouse.

See our end-to-end example with Zapier here.

Webhooks can be registered in the Admin, by going to Integrations > Webhooks and clicking "Create a Webhook"

Go to Admin

Give your webhook a name and enter the URL where Wonderment should send the data.

Wonderment sends data for many types of shipping related events. You can learn more about them here. By default, all events will be sent to your URL, but you can also choose to limit sending to only specific events.

Confirm you have the correct URL, and test your server response by using the "Send Test" button. This will send a test event to the webhook URL. The response status should be 200, other codes such as 404, 403, and others, indicate an error sending data to the webhook endpoint.

Wonderment expects the webhook destination to return an HTTP 200 status code to confirm receipt. If your destination returns a non-200 response, Wonderment will try to deliver the webhook again.

If Wonderment encounters any non-200 response 20 times in a row for a webhook it will be deactivated temporarily until the issue is resolved.

Webhooks can be reactivated in Wonderment Settings when your destination is operating again.

Webhooks are delivered with a header of X-Wonderment-Token to validate that the source of the webhook is legitimate. The token is found on the main integration page.

...
X-Wonderment-Token: _YOUR TOKEN_
Content-Type: application/json
... 
{
	...
	"token": "_YOUR TOKEN_"
	...
}

The list of webhooks on your account will also let you know the most recent HTTP response status for that webhook.

All Wonderment Webhooks come with the same data attached as our Klaviyo and Postscript integrations. As a summary of the fields: