Webhooks basics

Webhooks are a way to notify your application when an event occurs, such as a new order. They allow for a deeper e-commerce integration of your shopping cart with other systems.

Snipcart will send you a POST to a URL that you can provide in the dashboard.

Your endpoint should return the appropriate data with Content-Type application/json and status code 200.

If you're not familiar with webhooks, consider reading this post first.

Configure webhook URL

To configure this setting, first log into the Snipcart dashboard and head to Store configurations → Webhooks.

The URL you provide must be an absolute URL.

We present examples on how to consume Webhook requests further down this entry.

You can input multiple webhooks URLs separated by semicolons. Ex: https://example.com/webhooks; https://example2.com/webhooks/

Secure your Webhook endpoint

If your data is protected and you want to make sure the request is coming from Snipcart, you can use the X-Snipcart-RequestToken header. We add this header to each request made to an external website. The token is valid for one hour after its creation. This is also true for webhooks requests. You can then use this token and call back our API—think of it as a handshake.

The endpoint you'll need to make a GET request to: https://app.snipcart.com/api/requestvalidation/{token}.

Was this article helpful?