{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/docs/mcp/tools/events-webhooks/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Events & Webhooks

\n

This page covers tools in the Events & Webhooks domain, powered by the Eventus API. Events represent activity across the Shipwell platform (e.g. shipment.created, shipment.carrier_assigned, order.updated). Webhooks subscribe to those events and deliver payloads to your endpoints.

\n

Event Tools

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ToolDescriptionUse CaseAccess
list_eventsList platform events with filters\"Show me all shipment events from the last 24 hours\"Read
get_eventGet a specific event by IDRetrieve the full payload of an event for debugging or auditRead
list_event_namesList all valid event name strings by versionDiscover available event types before configuring webhook subscriptionsRead
\n
Note

Call list_event_names first to get the exact event name strings (e.g. shipment.carrier_assigned) required when setting enabled_events on a webhook.

\n

Webhook Tools

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ToolDescriptionUse CaseAccess
list_webhooksList all webhook configurationsView existing webhook subscriptions and their statusRead
get_webhookGet a single webhook by IDInspect which events a webhook is subscribed to and its endpoint URLRead
create_webhookCreate a new webhook subscriptionSubscribe an endpoint to receive shipment.created or other platform eventsWrite
update_webhookUpdate a webhook (full replacement)Replace all webhook settings including URL, enabled events, and statusWrite
patch_webhookUpdate a single webhook fieldToggle a webhook ACTIVE/INACTIVE without touching other fieldsWrite
delete_webhookDelete a webhook subscriptionRemove a webhook that is no longer neededWrite
\n
Note

Prefer patch_webhook over update_webhook when changing a single field — update_webhook is a full PUT replacement that will overwrite all fields.

\n

Webhook Attempt Tools

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ToolDescriptionUse CaseAccess
list_webhook_attemptsList delivery attempts across all webhooks\"Show me all failed webhook deliveries in the last hour\"Read
get_webhook_attemptGet a specific delivery attempt by IDInspect the request and response for a failed webhook deliveryRead
retry_webhook_attemptRetry a failed delivery attemptRe-send the original event payload after fixing a down endpoint or auth issueWrite
","headings":[{"value":"Events & Webhooks","depth":1},{"value":"Event Tools","depth":2},{"value":"Webhook Tools","depth":2},{"value":"Webhook Attempt Tools","depth":2}]},"contentItem":{"data":{"lastModified":"2026-05-14T19:02:55.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":true,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"30168294-7faa-5048-8640-2678cdcf88ea__redocly content/docs/mcp/tools/events-webhooks/","seo":{"title":"Events & Webhooks","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"docs/mcp/tools/events-webhooks.md","pageBaseUrl":"/docs/mcp/tools/events-webhooks","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Events & Webhooks","id":"events--webhooks"},{"depth":2,"value":"Event Tools","id":"event-tools"},{"depth":2,"value":"Webhook Tools","id":"webhook-tools"},{"depth":2,"value":"Webhook Attempt Tools","id":"webhook-attempt-tools"}]},"data":{"title":""},"catalogInfo":null,"link":"/docs/mcp/tools/events-webhooks/","sidebarName":"developerPortal","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}