After building, testing, and deploying your webhook to production, set up the endpoint so Stripe knows where to send live mode events. It’s also helpful to go through the development checklist to ensure a smooth transition when taking your integration live.
Add your webhook endpoint to your account
Add endpoints in the Dashboard
Stripe supports two endpoint types, Account and Connect. Create an endpoint for Account unless you’ve created a Connect application.
In the Dashboard’s Webhooks settings section, click Add endpoint to reveal a form to add a new endpoint for receiving events. You can enter any URL as the destination for events. You can choose to be notified of all event types, or only specific ones. You can find a full list of all event types in the API docs.
Add endpoints with the API
You can also programmatically create webhook endpoints. As with the form in the Dashboard, you can enter any URL as the destination for events and which event types to subscribe to. To receive events from connected accounts, use the connect parameter.
The following example creates an endpoint that notifies you when charges succeed or fail.
curl https://api.stripe.com/v1/webhook_endpoints \ -u\ -d "url"="https://example.com/my/webhook/endpoint" \ -d "enabled_events"="charge.failed" \ -d "enabled_events"="charge.succeeded"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Manage webhook endpoints
Existing webhook endpoints can be updated or deleted in the Dashboard’s Webhooks settings section. You also have the option of disabling a webhook endpoint temporarily. Stripe does not retry any notifications that are generated while the endpoint is disabled. Alternatively, you can manage webhook endpoints programmatically.