Enabling Webhooks
Webhooks are a subscription feature and have to be enabled on the account before endpoints can be registered.- In the dashboard sidebar, go to Settings → Webhooks
- If your plan includes webhooks, click Enable Webhooks
- Once enabled, manage endpoints in the embedded webhooks portal on the page
Adding an Endpoint
The webhooks page embeds a secure webhooks portal, and endpoint management happens inside that embedded portal rather than in storekit’s own screens.- Open Settings → Webhooks
- In the embedded portal, add a new endpoint
- Enter your endpoint URL (e.g.,
https://example.com/webhooks/storekit) - Select the event types you want to receive
- Save your endpoint
Endpoint Requirements
Your endpoint must:- Be publicly accessible via HTTPS
- Accept POST requests
- Return a
2xxstatus code within 30 seconds - Have CSRF protection disabled for this route
Choosing Event Types
You can subscribe to specific event types or receive all events. We recommend only subscribing to the events you need to minimize unnecessary traffic. See the Webhook Events page for a complete list of available events.Limiting an Endpoint to Some Stores
Every message is tagged with the ID of the store it belongs to, as a Svix channel. An endpoint with no channels set receives messages for every store on your account. To limit an endpoint to certain stores, add their store IDs as channels on the endpoint in the embedded portal. An endpoint with channels set does not receive messages that have no channel.account.holder.payout messages are tagged with up to five of the stores that share the payout account.
Testing Your Endpoint
Before going live, test your endpoint to ensure it’s working correctly:- Send a test event from the embedded webhooks portal
- Check that your endpoint receives the test webhook
- Verify your endpoint returns a
2xxresponse