Hookdeck
Webhook management gateway for events, requests, sources, destinations, connections, bookmarks, and bulk retries.
Tailored to webhook reliability work that bulk-retries failed events, cancels scheduled deliveries, configures custom domains, and audits delivery history.
Example Use Cases
These are the Hookdeck actions Snow can use when building apps with you. Connecting an account does not make Snow run these on its own.
Tool to retrieve a specific Hookdeck event by ID. Use when you need detailed information about an event including status, delivery attempts, and payload data.
Tool to query aggregated event metrics with time-based grouping and filtering. Use when you need to analyze event patterns, calculate statistics, or generate reports over specific time periods.
Tool to retrieve a specific Hookdeck delivery attempt by ID. Use when you have an attempt ID and need delivery details including status, response codes, timing, and errors.
Tool to retrieve details of a specific Hookdeck integration. Use when you need to inspect integration configuration, verify credentials, or check which sources are using the integration.
Tool to publish a webhook event to Hookdeck using the Publish API. Use when testing webhook flows or sending events from your application.
Tool to update an existing Hookdeck connection by its ID. Use when you need to modify a connection's description, name, or rules.
Tool to add a custom domain to the Hookdeck project. Use when you need to configure a custom hostname for receiving webhooks.
Tool to create a bulk cancellation job for events. Use when you need to cancel multiple events matching filters.
Initiate a bulk retry for multiple events matching the specified filters. Use this to retry failed webhook deliveries in bulk instead of one at a time. The query must include at least one filter - common usage is to filter by status='FAILED'. The operation runs asynchronously and returns immediately with progress tracking info.
Tool to cancel an ongoing events bulk retry operation. Use when you need to stop a bulk retry that is currently in progress (e.g., if you realize the retry conditions were incorrect or the issue needs to be addressed before retrying).
Cancel all future delivery attempts for a Hookdeck event. Use this to stop scheduled retries when you need to prevent further delivery attempts (e.g., due to known issues with the destination or invalid payload). Note: Events already in SUCCESSFUL or FAILED status cannot be cancelled but the API will return the event unchanged.
Tool to cancel all future scheduled retries for an event. Use when you need to mute automatic retry attempts after repeated failures.
Tool to cancel an in-progress requests bulk retry operation. Use when you need to stop a bulk retry that is currently running.
Tool to count Hookdeck connections with optional filters. Use when you need to get the total number of connections matching specific criteria.
Tool to count Hookdeck destinations with optional filters. Use when you need to get a total count of destinations without retrieving full details.
Tool to count Hookdeck sources with optional filters. Use when you need to get a total count of sources without retrieving full details.
Tool to create a bookmark for a specific event request in Hookdeck. Bookmarks allow you to catalog and replay specific webhook requests. Use this to save important or edge-case requests for testing, debugging, or documentation purposes. Bookmarked request data is exempt from the archiving period and remains available as long as it is bookmarked.
Tool to create a connection between a source and a destination. Use after setting up or referencing source/destination.
Tool to create a new Hookdeck destination. Use after setting up sources when you need to route events to endpoints.
Tool to create a new Hookdeck integration. Use when you need to set up authentication or verification for webhook sources using providers like API keys, HMAC, Basic Auth, or third-party services.
Tool to create an issue trigger in Hookdeck. Use when you need to set up automated notifications for delivery failures, transformation errors, or backpressure events.
Tool to create a new Hookdeck source. Use after setting up your project when you need to receive and route incoming webhooks.
Tool to create a new Hookdeck transformation. Use when you need to execute custom JavaScript to modify event payloads before delivery.
Tool to create an ignored events bulk retry operation. Use when you need to retry multiple ignored events matching specific filters. The query must include at least one filter parameter (webhook_id, cause, or transformation_id) - empty queries are not allowed.
Tool to delete a specific bookmark by its ID. Use when you need to permanently remove a bookmark after confirming it's no longer needed.
Tool to delete a specific connection by its ID. Use when you need to permanently remove a connection after confirming it's no longer needed.
Permanently deletes a Hookdeck destination by its ID. This action also deletes all connections that rely on the destination. The associated event data is retained for the remainder of your retention window. This operation is idempotent - deleting a non-existent destination will still return success.
Tool to delete a specific integration by its ID. Use when you need to permanently remove an integration after confirming it's no longer needed.
Tool to delete a specific issue trigger by its ID. Use when you need to permanently remove an issue trigger after confirming it's no longer needed.
Tool to delete a specific source by its ID. Use when you need to permanently remove a source after confirming it's no longer needed.
Permanently delete a Hookdeck transformation by its ID. The transformation must not be in use by any connections before deletion. Returns the ID of the deleted transformation on success. Use this when you need to clean up unused transformations from your Hookdeck workspace.
Tool to disable a connection by its ID. Use when you need to temporarily stop event delivery through a connection without deleting it.
Tool to disable a Hookdeck destination. Use when you need to temporarily stop event delivery to a destination without deleting it. Disabled destinations can be re-enabled later.
Tool to disable a Hookdeck issue trigger. Use when you need to temporarily stop notifications for a specific issue trigger without deleting it. The trigger can be re-enabled later if needed.
Tool to disable a Hookdeck source. Use when you need to stop a source from accepting new webhook events without deleting it.
Tool to enable a disabled Hookdeck connection. Use when you need to reactivate a previously disabled connection to resume event routing.
Enable a previously disabled Hookdeck destination by its ID. This allows events to be delivered to the destination again.
Tool to enable a Hookdeck issue trigger. Use when you need to activate an issue trigger that was previously disabled.
Tool to enable a disabled Hookdeck source. Use when you need to reactivate a source that was previously disabled.
Tool to generate a preview plan for bulk event cancellation. Use when you need to estimate how many events would be cancelled by a query before executing the actual bulk cancel operation.
Tool to generate an events bulk retry plan. Use when you need to estimate the scope of a bulk retry operation before executing it. Returns the estimated number of events that would be retried and the number of batches required.
Generate an ignored events bulk retry plan to estimate the scope before execution. Use this to preview how many events would be retried and how many batches are needed. This action does not execute the retry - it only provides estimates for planning purposes.
Tool to generate a requests bulk retry plan. Use when you need to estimate the number of requests and batches for a bulk retry operation before executing it. Accepts the same query filters as the List Requests endpoint.
Lists delivery attempts for your Hookdeck account. Attempts represent individual HTTP delivery tries to destination URLs. Use this to monitor delivery status, debug failures, and track retry attempts. Filter by event_id to see all attempts for a specific event. Only attempts with status SUCCESSFUL or FAILED are returned.
Tool to query aggregated attempt metrics with time-based grouping and filtering. Use when you need to analyze delivery attempt patterns over time, calculate statistics like attempt counts, or group metrics by dimensions such as status or destination.
Tool to retrieve the raw body data of a bookmarked request. Use when you need to access the original unmodified request body payload that was bookmarked in Hookdeck.
Tool to retrieve the status of a bulk event cancellation operation. Use when you need to check the progress or completion status of a bulk cancel job. The bulk cancel ID is returned when initiating a bulk cancel operation.
Tool to list event bulk cancel operations for your Hookdeck account. Use when you need to retrieve bulk cancel operation logs, filter by status or time, and paginate through results.
Tool to retrieve bulk retry operations for Hookdeck events. Use when you need to check the status of bulk retry jobs, monitor their progress, or list historical bulk retry operations.
Tool to retrieve the status of a bulk event retry operation. Use when you need to check the progress or completion status of a bulk retry job. The bulk retry ID is returned when initiating a bulk retry operation.
Tool to retrieve the raw body data of an event. Use when you need to access the original unmodified request body payload of a Hookdeck event.
Tool to list events for your Hookdeck account. Use when you need to retrieve delivery logs, filter by status or time, and paginate through results.
Tool to query event metrics grouped by individual issue IDs. Uses arrayJoin to create one row per issue per event, enabling per-issue analytics. Use when tracking which issues affect the most events over time.
Tool to query aggregated events pending timeseries metrics with time-based grouping and filtering. Use when you need to analyze pending event trends over time, monitor event backlogs, or generate time-series reports with custom granularity. Supports grouping by dimensions like source or destination.
Tool to retrieve a single bookmark by its ID. Use when you need to fetch details of a specific bookmark.
Retrieves details of a specific Hookdeck connection by its ID. Returns the connection configuration including its source, destination, and any configured rules. Use this to inspect connection settings, verify configuration, or get source/destination details.
Retrieve details of a specific Hookdeck destination by ID. Use this tool to get the full configuration and status of a destination, including its URL, authentication settings, rate limits, and timestamps.
Tool to retrieve a list of Hookdeck integrations. Use when you need to list all integrations or filter them by label or provider.
Tool to get the count of Hookdeck issues with optional filters. Use when you need to retrieve the total number of issues matching specific criteria without fetching the full list.
Tool to retrieve a single Hookdeck issue trigger by its ID. Use when you need to get detailed information about a specific issue trigger configuration.
Retrieve detailed information about a specific Hookdeck request by ID. Use this tool to inspect a webhook request including its body, headers, query parameters, and processing status. The request_id can be obtained from the HOOKDECK_GET_REQUESTS action. Returns complete request data including verification status, rejection cause (if any), and event counts.
Tool to retrieve details of a specific Hookdeck source. Use after confirming the source ID.
Retrieves the complete details of a specific Hookdeck transformation by its ID. Use this tool when you need to inspect a transformation's JavaScript code, environment variables, or metadata. Requires a valid transformation_id which can be obtained from HOOKDECK_GET_TRANSFORMATIONS. Returns the transformation's code, name, environment variables, and timestamps.
Tool to retrieve ignored events bulk retry operations for Hookdeck. Use when you need to check the status of ignored events bulk retry jobs, monitor their progress, or list historical ignored events bulk retry operations.
Tool to retrieve the status of an ignored events bulk retry operation. Use when you need to check the progress or completion status of a bulk retry job for ignored events.
Tool to list issue triggers for your Hookdeck account. Use when you need to retrieve configured issue triggers and their notification settings.
Tool to query queue depth metrics for destinations (pending events count and age). Use when you need to analyze event queue depth over time, monitor pending events, or track the age of the oldest pending event for destinations.
Tool to retrieve bulk retry operations for Hookdeck requests. Use when you need to check the status of request bulk retry jobs, monitor their progress, or list historical request bulk retry operations.
Tool to retrieve the status of a requests bulk retry operation. Use when you need to check the progress or completion status of a bulk retry job for webhook requests.
Tool to retrieve events associated with a specific Hookdeck request. Use when you need to get all events that were created from a particular request.
Retrieve the list of ignored events for a specific Hookdeck request. Use this tool when you need to inspect why certain events were ignored for a particular request. The request ID can be obtained from the HOOKDECK_GET_REQUESTS action. Returns a paginated list of ignored events with their causes and metadata.
Tool to retrieve the raw body data of a request. Use when you need to access the original unmodified request body payload of a Hookdeck request.
Tool to query aggregated request metrics with time-based grouping and filtering. Use when you need to analyze request patterns over time, calculate statistics like request counts, or group metrics by dimensions such as status or source.
Tool to retrieve all sources associated with your Hookdeck account. Use when you need to list or filter hook sources.
Retrieve a specific transformation execution by transformation ID and execution ID. Use this tool to inspect execution details including original and transformed event data, logs, and any issues that occurred.
Tool to retrieve executions for a specific Hookdeck transformation. Use when you need to inspect transformation execution logs, debug transformation failures, or analyze transformation performance.
Tool to list Hookdeck transformations. Use when you need to retrieve or filter your Hookdeck transformations.
Tool to get the count of Hookdeck transformations with optional filters. Use when you need to get the total number of transformations without retrieving full details.
Tool to query aggregated transformation execution metrics with time-based grouping and filtering. Use when you need to analyze transformation patterns over time, calculate statistics like execution counts, or group metrics by dimensions such as transformation_id or status.
Tool to pause a Hookdeck connection. Use when you need to temporarily stop event delivery for a connection without deleting it.
Upsert (create or update) a Hookdeck connection between a source and destination. The connection is identified by the source and destination combination. If a connection with the given source and destination exists, it will be updated. Otherwise, a new connection is created. Use this tool to: - Create a new connection between a source and destination - Update an existing connection's name, description, or rules - Configure webhook routing with retry, filter, or transform rules
Tool to list Hookdeck connections. Use when you need to retrieve or filter your configured connections. Each connection in the response embeds full source and destination objects; reuse these nested objects directly instead of making additional fetch calls.
Tool to list Hookdeck destinations. Use when you need to retrieve or filter your configured destinations.
Tool to list Hookdeck requests. Use when you need to retrieve requests with optional filters and pagination.
Tool to list all issues detected in your Hookdeck account. Use when you need to retrieve and filter issues by type, status, or time.
Tool to list all custom domains and their verification statuses for the Hookdeck project. Use when you need to view configured custom domains, check their verification status, or monitor SSL certificate details.
Tool to list bookmarks. Use when you need to retrieve your Hookdeck account's bookmarks with optional filters and pagination. Use after authenticating your session.
Replay (retry) a specific Hookdeck event delivery. Use this to manually retry a failed or queued event. The event will be re-queued for delivery to its destination. After replay, Hookdeck will attempt to deliver the event; if successful, any scheduled automatic retries will be canceled. Note: The event's connection must still be active - events with deleted connections cannot be replayed.
Tool to resolve a Hookdeck issue. Use after confirming the underlying issue has been addressed.
Retrieves detailed information about a specific Hookdeck issue by its ID. Use this tool when you need to get complete details about a known issue, including its status, type (delivery/transformation/backpressure), aggregation keys, timestamps, and reference information. To find issue IDs, use the List Issues action first.
Tool to send HTTP requests to a Hookdeck Source URL. Use when ingesting test payloads to generate events for testing HOOKDECK_GET_EVENT.
Tool to test a Hookdeck transformation code before deploying it. Use when you need to verify that transformation JavaScript code works correctly with sample request data.
Tool to toggle webhook notifications for the project. Use when you need to enable or disable webhook notifications and configure which topics to receive.
Trigger a Hookdeck bookmark to replay its stored webhook request. When triggered, a new event is created from the bookmarked request data and delivered to the associated destination. This is useful for testing webhook handlers or replaying specific scenarios during development. Note: The bookmark must be associated with an active connection (webhook). Triggering a bookmark with a deleted connection will fail with a 404 error.
Tool to unpause a paused Hookdeck connection. Use when you need to resume event processing for a previously paused connection.
Tool to update an existing bookmark in Hookdeck. Use when you need to modify a bookmark's label, name, associated event data, or connection. At least one field (label, name, event_data_id, or webhook_id) must be provided for the update.
Tool to update an existing Hookdeck destination. Use when you need to modify a destination's settings after creation.
Tool to update an existing Hookdeck integration. Use when you need to modify integration configuration, change labels, update provider settings, or enable/disable features.
Tool to update an issue trigger in Hookdeck. Use when you need to modify the name, channels, configs, or disabled status of an existing issue trigger.
Update an existing Hookdeck source's name, type, or description. Use this tool when you need to: - Rename a source - Change a source's type (e.g., from WEBHOOK to STRIPE) - Update or add a description to a source Note: Source configuration (allowed_http_methods, auth settings) cannot be updated via this endpoint. At least one field (name, type, or description) must be provided.
Tool to update an existing Hookdeck transformation. Use when you need to modify a transformation's code, name, or environment variables after creation.
Tool to create or update a Hookdeck destination. If a destination with the given name exists, it updates it; otherwise creates a new one. Use when configuring webhook endpoints for event routing.
Tool to create or update an issue trigger in Hookdeck using upsert semantics. If a trigger with the given name exists, it will be updated; otherwise, a new trigger is created.
Tool to create or update a Hookdeck source by name. If a source with the given name exists, it will be updated; otherwise, a new source is created.
Tool to create or update a Hookdeck transformation by name. Use when you want to ensure a transformation exists with specific code, creating it if it doesn't exist or updating it if it does.