Retrieve a webhook
Retrieve one webhook endpoint by ‘webhookId’ for the authenticated seller.
Use this endpoint when loading details for a specific endpoint before editing, testing, or troubleshooting.
Typical use cases:
- Populate a webhook details page.
- Confirm the active subscription set before replacing subscriptions.
- Inspect latest delivery health fields (last success/failure and failure counters).
Behavior notes:
- Returns 404 when the webhook id is unknown or does not belong to the current seller.
- Response shape matches webhook records returned by list endpoints, including subscriptions.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Identifier of the webhook endpoint to retrieve
Response
Webhook endpoint
Represents a webhook endpoint configured by a seller to receive event notifications.
Unique identifier for the webhook endpoint
Destination URL for webhook deliveries
Indicates whether the webhook is currently active
Additional headers sent with each webhook request
Shared secret used to generate webhook signatures
Timestamp of the most recent successful delivery
Timestamp of the most recent failed delivery
Current number of consecutive delivery failures
Threshold at which the webhook will automatically be disabled
Timestamp when the webhook endpoint was created
Timestamp when the webhook endpoint was last updated
Event types that the webhook is subscribed to
Event types that can trigger a webhook notification
LISTING_CREATED, LISTING_UPDATED, LISTING_DELETED, ORDER_CREATED, ORDER_UPDATED, TEST Optional human readable description