Retrieve an event
Returns one event, with the object it happened to in `data`. Its id is the value a delivery carries in its `webhook-id` header, so a handler can read the event back from the API before acting on it. Only events belonging to the key's merchant and mode are visible.
Returns one event, with the object it happened to in data. Its id is the value a delivery carries in its webhook-id header, so a handler can read the event back from the API before acting on it. Only events belonging to the key's merchant and mode are visible.
Authorization
secretKey Your secret key: sk_live_… or sk_test_….
In: header
Path Parameters
The event's id, which starts with evt_. A delivery carries the same value in webhook-id.
^evt_[0-9a-f]{32}$Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/events/evt_3f2b8c1e9a4d4e7b8c2a1d5e6f7a8b9c"{ "object": "event", "event_id": "evt_3f2b8c1e9a4d4e7b8c2a1d5e6f7a8b9c", "type": "payment.succeeded", "livemode": true, "created_at": "2019-08-24T14:15:22Z", "data": {}}Update a webhook endpoint PATCH
Changes an endpoint's URL, description, subscribed event types, or whether it is disabled. Fields you leave out keep their values, and `event_types` replaces the whole list rather than adding to it; an empty list means every event type. A new URL is checked exactly as at creation. The signing secret never changes. While an endpoint is disabled, events are still recorded but nothing is delivered to it, and deliveries already queued for it are marked failed rather than held.
List events GET
Lists the events recorded for the key's merchant and mode, newest first, whether or not an endpoint was listening when they happened. Filter by `type` to walk one kind. One page carries `items`, `has_more` and `next_cursor`; pass `next_cursor` back as `cursor` for the next page. Use it to catch up on what happened while your endpoint was down, and to reconcile your records against what Utopia sent.