Retrieve a webhook endpoint
Returns one webhook endpoint: its URL, the event types it is subscribed to and whether it is disabled. The signing secret is not part of this response; read it with `GET /webhooks/{id}/secret`.
Returns one webhook endpoint: its URL, the event types it is subscribed to and whether it is disabled. The signing secret is not part of this response; read it with GET /webhooks/{id}/secret.
Authorization
secretKey Your secret key: sk_live_… or sk_test_….
In: header
Path Parameters
The webhook endpoint's id, which starts with wh_.
^wh_[0-9a-f]{32}$Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/webhooks/wh_3f2b8c1e9a4d4e7b8c2a1d5e6f7a8b9c"{ "object": "webhook", "webhook_id": "wh_3f2b8c1e9a4d4e7b8c2a1d5e6f7a8b9c", "url": "http://example.com", "description": "string", "event_types": [ "payment.succeeded" ], "disabled": true, "livemode": true, "created_at": "2019-08-24T14:15:22Z"}Delete a webhook endpoint DELETE
Deletes the endpoint, along with the deliveries still queued for it, and answers `{ "object": "webhook", "webhook_id", "deleted": true }`. This cannot be undone and the signing secret cannot be recovered afterwards: to stop deliveries and keep both, update the endpoint with `disabled: true` instead. The events themselves are kept and stay readable under `/events`.
Retrieve an endpoint's signing secret GET
Returns the endpoint's `whsec_…` signing secret, for a server that has lost the copy it was given when the endpoint was created. Every delivery to this endpoint is signed with it, following the Standard Webhooks specification. The secret never changes: to rotate it, add a second endpoint, move your traffic across and delete the old one.