# Hookdeck

Hookdeck is a platform that enables developers to manage, monitor, and secure webhooks and API events.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 113
- **Triggers:** 0
- **Slug:** `HOOKDECK`
- **Version:** 20260227_00

## Tools

### Add Custom Domain

**Slug:** `HOOKDECK_ADD_CUSTOM_DOMAIN`

Tool to add a custom domain to the Hookdeck project. Use when you need to configure a custom hostname for receiving webhooks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hostname` | string | Yes | The custom hostname to attach to the project |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Cancel Hookdeck Events

**Slug:** `HOOKDECK_BULK_CANCEL_EVENTS`

Tool to create a bulk cancellation job for events. Use when you need to cancel multiple events matching filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | Yes | Filter object specifying conditions for selecting events to cancel. At least one filter property should be provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Retry Hookdeck Events

**Slug:** `HOOKDECK_BULK_RETRY_EVENTS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | Yes | Filter object specifying conditions for selecting events to retry. Must include at least one filter (e.g., status='FAILED' to retry all failed events). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Hookdeck Event

**Slug:** `HOOKDECK_CANCEL_EVENT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | The unique identifier of the Hookdeck event to cancel. Obtain this from HOOKDECK_GET_EVENTS or event notification webhooks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Event Bulk Retry

**Slug:** `HOOKDECK_CANCEL_EVENT_BULK_RETRY`

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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the bulk retry operation to cancel (e.g., 'bch_DiPOKivhmufni7'). Obtain this from the BulkRetryEvents action response or bulk retry status endpoints. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Request Bulk Retry

**Slug:** `HOOKDECK_CANCEL_REQUEST_BULK_RETRY`

Tool to cancel an in-progress requests bulk retry operation. Use when you need to stop a bulk retry that is currently running.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Bulk retry ID to cancel |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Hookdeck Scheduled Retries

**Slug:** `HOOKDECK_CANCEL_SCHEDULED_RETRIES`

Tool to cancel all future scheduled retries for an event. Use when you need to mute automatic retry attempts after repeated failures.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | The unique identifier of the event to cancel scheduled retries for. Use HOOKDECK_GET_EVENTS to retrieve event IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count Hookdeck Connections

**Slug:** `HOOKDECK_COUNT_CONNECTIONS`

Tool to count Hookdeck connections with optional filters. Use when you need to get the total number of connections matching specific criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `disabled` | boolean | No | Include disabled resources in the response |
| `paused_at` | string | No | Date the connection was paused |
| `source_id` | string | No | Filter by associated source IDs |
| `disabled_at` | string | No | Date the connection was disabled |
| `destination_id` | string | No | Filter by associated destination IDs |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count Hookdeck Destinations

**Slug:** `HOOKDECK_COUNT_DESTINATIONS`

Tool to count Hookdeck destinations with optional filters. Use when you need to get a total count of destinations without retrieving full details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by destination IDs. |
| `name` | string | No | Filter by destination name. |
| `disabled` | boolean | No | Include disabled resources in the response if true. |
| `disabled_at` | string | No | Filter destinations disabled at a specific date or with operators (e.g., '<2023-02-01T00:00:00Z'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count Hookdeck Sources

**Slug:** `HOOKDECK_COUNT_SOURCES`

Tool to count Hookdeck sources with optional filters. Use when you need to get a total count of sources without retrieving full details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by source IDs. |
| `name` | string | No | Filter by source name. |
| `type` | string | No | Filter by source type. |
| `disabled` | boolean | No | Include disabled resources in the response if true. |
| `disabled_at` | string | No | Filter sources disabled at a specific date or with operators (e.g., '<2023-02-01T00:00:00Z'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Hookdeck Bookmark

**Slug:** `HOOKDECK_CREATE_BOOKMARK`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label` | string | Yes | Descriptive name for the bookmark shown in the Hookdeck UI and CLI. |
| `webhook_id` | string | Yes | ID of the associated connection (webhook) where the event originated. Obtain this from event objects or via HOOKDECK_GET_CONNECTIONS. |
| `event_data_id` | string | Yes | ID of the event data to bookmark. Obtain this from event objects via HOOKDECK_GET_EVENTS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Hookdeck Connection

**Slug:** `HOOKDECK_CREATE_CONNECTION`

Tool to create a connection between a source and a destination. Use after setting up or referencing source/destination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional unique name for the connection. |
| `rules` | array | No | Optional list of rules for the connection (retry, filter, transform, delay, deduplicate). |
| `source` | object | No | Inline input for creating a source. |
| `source_id` | string | No | ID of an existing source to bind to this connection. |
| `description` | string | No | Optional human-readable description for the connection. |
| `destination` | object | No | Inline input for creating a destination. |
| `destination_id` | string | No | ID of an existing destination to bind to this connection. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Hookdeck Destination

**Slug:** `HOOKDECK_CREATE_DESTINATION`

Tool to create a new Hookdeck destination. Use after setting up sources when you need to route events to endpoints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Unique destination name; letters, numbers, hyphens, or underscores only; max 155 chars. |
| `type` | string ("HTTP" | "CLI" | "MOCK_API") | No | Destination type; one of HTTP, CLI, or MOCK_API. Defaults to HTTP. |
| `config` | object | No | Configuration object for the destination; fields vary by destination type. |
| `description` | string | No | Human-readable description of the destination. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Ignored Event Bulk Retry

**Slug:** `HOOKDECK_CREATE_IGNORED_EVENT_BULK_RETRY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | Yes | Filter object specifying conditions for selecting ignored events to retry. Must include at least one filter (webhook_id, cause, or transformation_id). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Hookdeck Integration

**Slug:** `HOOKDECK_CREATE_INTEGRATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label` | string | No | Label of the integration for easy identification. |
| `configs` | object | No | Decrypted key/value object of the associated configuration for the provider. Required fields vary by provider (e.g., 'api_key' for API_KEY provider, 'webhook_secret_key' for HMAC, 'username' and 'password' for BASIC_AUTH). |
| `features` | array | No | List of features to enable for this integration. |
| `provider` | string ("AIPRISE" | "DOCUSIGN" | "INTERCOM" | "HMAC" | "BASIC_AUTH" | "API_KEY" | "MANAGED" | "HOOKDECK_OUTPOST" | "SANITY" | "BIGCOMMERCE" | "OPENAI" | "POLAR" | "BRIDGE" | "CHARGEBEE_BILLING" | "CLOUDSIGNAL" | "COINBASE" | "COURIER" | "CURSOR" | "MERAKI" | "FIREBLOCKS" | "FRONTAPP" | "ZOOM" | "TWITTER" | "RECHARGE" | "RECURLY" | "RING_CENTRAL" | "STRIPE" | "PROPERTY-FINDER" | "QUOTER" | "SHOPIFY" | "TWILIO" | "GITHUB" | "POSTMARK" | "TALLY" | "TYPEFORM" | "PICQER" | "XERO" | "SVIX" | "RESEND" | "ADYEN" | "AKENEO" | "GITLAB" | "WOOCOMMERCE" | "OKTA" | "OURA" | "COMMERCELAYER" | "HUBSPOT" | "MAILGUN" | "PERSONA" | "PIPEDRIVE" | "SENDGRID" | "WORKOS" | "SYNCTERA" | "AWS_SNS" | "THREE_D_EYE" | "TWITCH" | "ENODE" | "FAVRO" | "LINEAR" | "SHOPLINE" | "WIX" | "NMI" | "ORB" | "PYLON" | "RAZORPAY" | "REPAY" | "SQUARE" | "SOLIDGATE" | "TRELLO" | "EBAY" | "TELNYX" | "DISCORD" | "TOKENIO" | "FISERV" | "FUSIONAUTH" | "BONDSMITH" | "VERCEL_LOG_DRAINS" | "VERCEL" | "TEBEX" | "SLACK" | "SMARTCAR" | "MAILCHIMP" | "NUVEMSHOP" | "PADDLE" | "PAYPAL" | "PORTAL" | "TREEZOR" | "PRAXIS" | "CUSTOMERIO" | "EXACT_ONLINE" | "FACEBOOK" | "WHATSAPP" | "REPLICATE" | "TIKTOK" | "TIKTOK_SHOP" | "AIRWALLEX" | "ASCEND" | "ALIPAY" | "ZENDESK" | "UPOLLO" | "SMILE" | "NYLAS" | "CLIO" | "GOCARDLESS" | "LINKEDIN" | "LITHIC" | "UTILA" | "ZEROHASH" | "AIRTABLE" | "ASANA" | "FASTSPRING" | "PAYPRO_GLOBAL" | "USPS" | "FLEXPORT") | No | Supported integration providers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Hookdeck Issue Trigger

**Slug:** `HOOKDECK_CREATE_ISSUE_TRIGGER`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional unique name to reference the issue trigger via API. |
| `type` | string ("delivery" | "transformation" | "backpressure") | Yes | Issue type: 'delivery', 'transformation', or 'backpressure'. |
| `configs` | object | No | Configuration object based on issue type. For delivery: {strategy: 'first_attempt', connections: '*'}. For transformation: {log_level: 'error', transformations: '*'}. For backpressure: {delay: 1000, destinations: '*'}. |
| `channels` | object | Yes | Notification channels configuration. At least one channel must be specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Hookdeck Source

**Slug:** `HOOKDECK_CREATE_SOURCE`

Tool to create a new Hookdeck source. Use after setting up your project when you need to receive and route incoming webhooks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Unique source name; letters, numbers, hyphens, or underscores only; max 155 chars. |
| `type` | string ("WEBHOOK" | "PUBLISH_API" | "AIPRISE" | "DOCUSIGN" | "INTERCOM") | No | Predefined source type. Omit for a generic webhook source. |
| `config` | object | No | Configuration object for the source; fields vary by source type. |
| `description` | string | No | Human-readable description of the source. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Hookdeck Transformation

**Slug:** `HOOKDECK_CREATE_TRANSFORMATION`

Tool to create a new Hookdeck transformation. Use when you need to execute custom JavaScript to modify event payloads before delivery.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `env` | object | No | Key-value environment variables to pass to the transformation. |
| `code` | string | Yes | JavaScript code to execute for the transformation. Must use the addHandler syntax with 'transform' as the handler type. The handler receives (request, context) parameters where request contains headers, body, query, parsed_query, and path. |
| `name` | string | Yes | Unique transformation name; letters, numbers, hyphens, or underscores only; max 155 chars. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Hookdeck Bookmark

**Slug:** `HOOKDECK_DELETE_BOOKMARK`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bookmark_id` | string | Yes | The unique identifier of the bookmark to permanently delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Hookdeck Connection

**Slug:** `HOOKDECK_DELETE_CONNECTION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `connection_id` | string | Yes | The unique identifier of the connection to permanently delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Hookdeck Destination

**Slug:** `HOOKDECK_DELETE_DESTINATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `destination_id` | string | Yes | The unique identifier of the destination to delete. Format: des_XXXXXXXXXXXX (e.g., des_abc123xyz456). Obtain this ID from HOOKDECK_GET_DESTINATIONS or HOOKDECK_CREATE_DESTINATION. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Hookdeck Integration

**Slug:** `HOOKDECK_DELETE_INTEGRATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the integration to permanently delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Hookdeck Issue Trigger

**Slug:** `HOOKDECK_DELETE_ISSUE_TRIGGER`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the issue trigger to permanently delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Hookdeck Source

**Slug:** `HOOKDECK_DELETE_SOURCE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The unique identifier of the source to permanently delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Hookdeck Transformation

**Slug:** `HOOKDECK_DELETE_TRANSFORMATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transformation_id` | string | Yes | The unique identifier of the transformation to permanently delete. Transformation IDs start with 'trs_' prefix. Note: A transformation can only be deleted if it is not being used by any connections. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Disable Hookdeck Connection

**Slug:** `HOOKDECK_DISABLE_CONNECTION`

Tool to disable a connection by its ID. Use when you need to temporarily stop event delivery through a connection without deleting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the connection to disable |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Disable Hookdeck Destination

**Slug:** `HOOKDECK_DISABLE_DESTINATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `destination_id` | string | Yes | The unique identifier of the destination to disable. Format: des_XXXXXXXXXXXX (e.g., des_wBqey0VM3ige). Obtain this ID from HOOKDECK_GET_DESTINATIONS or HOOKDECK_CREATE_DESTINATION. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Disable Hookdeck Issue Trigger

**Slug:** `HOOKDECK_DISABLE_ISSUE_TRIGGER`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Issue trigger ID to disable. Obtain this from list issue triggers or retrieve issue trigger endpoints. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Disable Hookdeck Source

**Slug:** `HOOKDECK_DISABLE_SOURCE`

Tool to disable a Hookdeck source. Use when you need to stop a source from accepting new webhook events without deleting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The unique identifier of the source to disable (e.g., 'src_1234567890abcdef') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enable Hookdeck Connection

**Slug:** `HOOKDECK_ENABLE_CONNECTION`

Tool to enable a disabled Hookdeck connection. Use when you need to reactivate a previously disabled connection to resume event routing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique ID of the connection to enable (e.g., 'web_EnFSYBHW1nX1') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enable Hookdeck Destination

**Slug:** `HOOKDECK_ENABLE_DESTINATION`

Enable a previously disabled Hookdeck destination by its ID. This allows events to be delivered to the destination again.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the destination to enable. Format: des_XXXXXXXXXXXX (e.g., des_wBqey0VM3ige). Obtain this ID from HOOKDECK_GET_DESTINATIONS or HOOKDECK_CREATE_DESTINATION. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enable Hookdeck Issue Trigger

**Slug:** `HOOKDECK_ENABLE_ISSUE_TRIGGER`

Tool to enable a Hookdeck issue trigger. Use when you need to activate an issue trigger that was previously disabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the issue trigger to enable |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enable Hookdeck Source

**Slug:** `HOOKDECK_ENABLE_SOURCE`

Tool to enable a disabled Hookdeck source. Use when you need to reactivate a source that was previously disabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_id` | string | Yes | The unique identifier of the source to enable (e.g., 'src_t724yotizx9dkm') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Event Bulk Cancel Plan

**Slug:** `HOOKDECK_GENERATE_EVENT_BULK_CANCEL_PLAN`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | Yes | Filter object specifying conditions for selecting events to preview cancellation. At least one filter property must be provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Event Bulk Retry Plan

**Slug:** `HOOKDECK_GENERATE_EVENT_BULK_RETRY_PLAN`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | Yes | Filter object specifying conditions for selecting events to include in the retry plan. Must include at least one filter (e.g., status='FAILED' to plan retry for all failed events). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Ignored Event Bulk Retry Plan

**Slug:** `HOOKDECK_GENERATE_IGNORED_EVENT_BULK_RETRY_PLAN`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | Yes | Filter object specifying which ignored events to include in the retry plan. Must include at least one filter (webhook_id, cause, or transformation_id). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Request Bulk Retry Plan

**Slug:** `HOOKDECK_GENERATE_REQUEST_BULK_RETRY_PLAN`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | No | Filter properties for the requests to be included in the bulk retry plan. Supports the same query parameters as the List Requests endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Attempt

**Slug:** `HOOKDECK_GET_ATTEMPT2`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `attempt_id` | string | Yes | The unique identifier of the Hookdeck attempt to retrieve (e.g., 'atm_dNDcsLgseeRpa4zUuuRS') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get attempts

**Slug:** `HOOKDECK_GET_ATTEMPTS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more attempt IDs (e.g., 'atm_xxx'). |
| `dir` | string | No | Sort direction: 'asc' for ascending or 'desc' for descending. Defaults to 'desc'. |
| `next` | string | No | Cursor token from a previous response to fetch the next page of results. |
| `prev` | string | No | Cursor token from a previous response to fetch the previous page of results. |
| `limit` | integer | No | Maximum number of attempts to return per page (1-250). Defaults to 100. |
| `event_id` | string | No | Filter by one or more event IDs to get attempts for specific events. |
| `order_by` | string | No | Field to sort results by. Defaults to 'created_at'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get attempts metrics

**Slug:** `HOOKDECK_GET_ATTEMPTS_METRICS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Additional filters to apply to the metrics query |
| `measures` | array | Yes | Metrics to calculate (e.g., 'count') |
| `date_range` | object | Yes | Date range with start and end timestamps in ISO 8601 format |
| `dimensions` | array | No | Dimensions to group metrics by |
| `granularity` | string | No | Time bucket granularity. Format: <number><unit> where unit is s (seconds 1-60), m (minutes 1-60), h (hours 1-24), d (days 1-31), w (weeks 1-4), M (months 1-12). Examples: '1s', '5m', '1h', '1d' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Bookmark

**Slug:** `HOOKDECK_GET_BOOKMARK`

Tool to retrieve a single bookmark by its ID. Use when you need to fetch details of a specific bookmark.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the bookmark to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bookmark Raw Body

**Slug:** `HOOKDECK_GET_BOOKMARK_RAW_BODY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bookmark_id` | string | Yes | The unique identifier of the bookmark to retrieve raw body data for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Connection

**Slug:** `HOOKDECK_GET_CONNECTION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `connection_id` | string | Yes | The unique ID of the connection to retrieve (starts with 'web_') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Hookdeck: Get Connections

**Slug:** `HOOKDECK_GET_CONNECTIONS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more connection IDs. |
| `dir` | string ("asc" | "desc") | No | Sort direction: asc or desc. Default: desc. |
| `next` | string | No | Cursor for next page of results. Value comes from the response body of the previous call. |
| `prev` | string | No | Cursor for previous page of results. Value comes from the response body of the previous call. |
| `limit` | integer | No | Page size: integer between 1 and 250. Defaults to 100. |
| `disabled` | boolean | No | Include disabled connections if true. |
| `order_by` | string | No | Sort key(s). Default: created_at. |
| `full_name` | string | No | Fuzzy match on combined 'source -> connection' name. |
| `paused_at` | object | No | Filter by paused date using operators (gte, gt, lte, lt). |
| `source_id` | string | No | Filter by one or more source IDs. |
| `disabled_at` | object | No | Filter by disabled date using operators (gte, gt, lte, lt). |
| `destination_id` | string | No | Filter by one or more destination IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Destination

**Slug:** `HOOKDECK_GET_DESTINATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `destination_id` | string | Yes | Unique identifier of the destination to retrieve (e.g., 'des_xxxxx'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Hookdeck: Get Destinations

**Slug:** `HOOKDECK_GET_DESTINATIONS`

Tool to list Hookdeck destinations. Use when you need to retrieve or filter your configured destinations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more destination IDs. |
| `dir` | string ("asc" | "desc") | No | Sort direction: asc or desc. Defaults to desc. |
| `name` | string | No | Filter by one or more destination names. |
| `next` | string | No | Cursor for next page. Extract from previous response's pagination metadata and pass here to advance pages. |
| `prev` | string | No | Cursor for previous page. |
| `type` | string | No | Filter by destination type. Allowed values: HTTP, CLI, MOCK_API. |
| `limit` | integer | No | Page size: integer between 1 and 255. Defaults to 100. |
| `disabled` | boolean | No | Include disabled destinations if true. |
| `order_by` | string ("name" | "created_at" | "updated_at") | No | Sort key: name, created_at, or updated_at. Defaults to created_at. |
| `disabled_at` | string | No | Filter destinations disabled at a specific timestamp or with operators. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event

**Slug:** `HOOKDECK_GET_EVENT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the Hookdeck event to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Bulk Cancel Status

**Slug:** `HOOKDECK_GET_EVENT_BULK_CANCEL`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Bulk cancel ID to retrieve (e.g., 'bch_8wrFV34ahWBqGa') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Bulk Cancels

**Slug:** `HOOKDECK_GET_EVENT_BULK_CANCELS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more bulk cancel IDs. |
| `dir` | string | No | Sort direction (asc or desc). |
| `next` | string | No | The ID to provide in the query to get the next set of results. |
| `prev` | string | No | The ID to provide in the query to get the previous set of results. |
| `limit` | integer | No | Result set size. |
| `query` | object | No | Filter for events to be included in the bulk cancel operation, use query parameters of Event. |
| `order_by` | string | No | Sort key for results. |
| `created_at` | string | No | Filter by date the bulk cancel was created. Accepts ISO-8601 string or operators dict like {'gte': '2023-01-01T00:00:00Z'}. |
| `in_progress` | boolean | No | Indicates if the bulk cancel is currently in progress. |
| `cancelled_at` | string | No | Filter by date the bulk cancel was cancelled. Accepts ISO-8601 string or operators dict like {'gte': '2023-01-01T00:00:00Z'}. |
| `completed_at` | string | No | Filter by date the bulk cancel completed. Accepts ISO-8601 string or operators dict like {'gte': '2023-01-01T00:00:00Z'}. |
| `query_partial_match` | boolean | No | Allow partial filter match on query property. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Bulk Retries

**Slug:** `HOOKDECK_GET_EVENT_BULK_RETRIES`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more bulk retry IDs. |
| `dir` | string | No | Sort direction for results: 'asc' for ascending or 'desc' for descending. |
| `next` | string | No | Cursor token to fetch the next page of results. Provided in pagination object of previous response. |
| `prev` | string | No | Cursor token to fetch the previous page of results. Provided in pagination object of previous response. |
| `limit` | integer | No | Maximum number of results to return per page. |
| `query` | object | No | Filter for events to be included in the bulk retry, using query parameters of Event filters (e.g., status, webhook_id, source_id). |
| `order_by` | string | No | Sort key for results. Common values: 'created_at', 'updated_at'. |
| `created_at` | string | No | Filter by date the bulk retry was created. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `in_progress` | boolean | No | Filter by whether the bulk retry is currently in progress. True for running operations, false for completed or cancelled. |
| `cancelled_at` | string | No | Filter by date the bulk retry was cancelled. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `completed_at` | string | No | Filter by date the bulk retry completed. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `query_partial_match` | boolean | No | Allow partial filter match on query property. When true, relaxes exact matching requirements. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Bulk Retry Status

**Slug:** `HOOKDECK_GET_EVENT_BULK_RETRY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Bulk retry ID to retrieve (e.g., 'bch_DiPOKivhmufni7') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Raw Body

**Slug:** `HOOKDECK_GET_EVENT_RAW_BODY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Event ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get events

**Slug:** `HOOKDECK_GET_EVENTS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more event IDs. |
| `dir` | string ("asc" | "desc") | No | Sort direction: asc or desc; default is 'desc'. |
| `next` | string | No | Cursor to fetch the next page. |
| `prev` | string | No | Cursor to fetch the previous page. |
| `limit` | integer | No | Page size; default 100; max 250. |
| `status` | string | No | Filter by event lifecycle status (e.g., SUCCESSFUL, QUEUED, FAILED). |
| `attempts` | object | No | Filter by number of delivery attempts with operators. E.g., {'gte': 2, 'lte': 5}. |
| `order_by` | string | No | Sort key; default is 'created_at'. |
| `source_id` | string | No | Filter by one or more source IDs. |
| `created_at` | object | No | Filter by event creation timestamp with operators. E.g., {'gte': '2023-01-01T00:00:00Z'}. |
| `webhook_id` | string | No | Filter by one or more connection (webhook) IDs. |
| `destination_id` | string | No | Filter by one or more destination IDs. |
| `response_status` | string | No | Filter by HTTP response status code(s) or with operators. E.g., 200, [200,404], or {'gte':400}. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get events by issue metrics

**Slug:** `HOOKDECK_GET_EVENTS_BY_ISSUE_METRICS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | Yes | Filters object with required issue_id field |
| `measures` | array | Yes | Array of metrics to calculate (e.g., 'count') |
| `date_range` | object | Yes | Date range with start and end timestamps in ISO 8601 format |
| `dimensions` | array | No | Array of dimension names to group by |
| `granularity` | string | No | Time bucket granularity. Format: <number><unit> where unit is s (seconds 1-60), m (minutes 1-60), h (hours 1-24), d (days 1-31), w (weeks 1-4), M (months 1-12). Examples: 1s, 5m, 1h, 1d |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Events Metrics

**Slug:** `HOOKDECK_GET_EVENTS_METRICS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Filter criteria for the metrics query |
| `measures` | array | Yes | Array of metric names to calculate (e.g., ['count', 'success_rate']) |
| `date_range` | object | Yes | Date range object with 'start' and 'end' fields in ISO 8601 format |
| `dimensions` | array | No | Dimensions to group by (e.g., ['source_id', 'destination_id']) |
| `granularity` | string | No | Time bucket granularity. Format: <number><unit> where unit is s (seconds 1-60), m (minutes 1-60), h (hours 1-24), d (days 1-31), w (weeks 1-4), M (months 1-12). Examples: 1s, 5m, 1h, 1d |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get events pending timeseries metrics

**Slug:** `HOOKDECK_GET_EVENTS_PENDING_TIMESERIES_METRICS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Optional filters to apply to the metrics query. |
| `measures` | array | Yes | List of measures to aggregate (e.g., 'count'). At least one measure is required. |
| `date_range` | object | Yes | Date range with start and end timestamps for the metrics query. |
| `dimensions` | array | No | List of dimensions to group results by (e.g., source_id, destination_id). |
| `granularity` | string | No | Time bucket granularity for grouping metrics. Format: <number><unit> where unit is s (seconds 1-60), m (minutes 1-60), h (hours 1-24), d (days 1-31), w (weeks 1-4), M (months 1-12). Examples: '1s', '5m', '1h', '1d', '1w', '1M'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Ignored Event Bulk Retries

**Slug:** `HOOKDECK_GET_IGNORED_EVENT_BULK_RETRIES`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more bulk retry IDs. |
| `dir` | string | No | Sort direction for results: 'asc' for ascending or 'desc' for descending. |
| `next` | string | No | Cursor token to fetch the next page of results. Provided in pagination object of previous response. |
| `prev` | string | No | Cursor token to fetch the previous page of results. Provided in pagination object of previous response. |
| `limit` | integer | No | Maximum number of results to return per page. |
| `query` | object | No | Filter by the bulk retry ignored event query object. This object specifies conditions for selecting ignored events (e.g., webhook_id, cause, transformation_id). |
| `order_by` | string | No | Sort key for results. Common values: 'created_at', 'updated_at'. |
| `created_at` | string | No | Filter by date the bulk retry was created. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `in_progress` | boolean | No | Filter by whether the bulk retry is currently in progress. True for running operations, false for completed or cancelled. |
| `cancelled_at` | string | No | Filter by date the bulk retry was cancelled. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `completed_at` | string | No | Filter by date the bulk retry completed. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `query_partial_match` | boolean | No | Allow partial filter match on query property. When true, relaxes exact matching requirements. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Ignored Event Bulk Retry Status

**Slug:** `HOOKDECK_GET_IGNORED_EVENT_BULK_RETRY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Bulk retry ID to retrieve (e.g., 'bch_FSTzBqxJLCpTF4') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Integration

**Slug:** `HOOKDECK_GET_INTEGRATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Integration ID to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Integrations

**Slug:** `HOOKDECK_GET_INTEGRATIONS`

Tool to retrieve a list of Hookdeck integrations. Use when you need to list all integrations or filter them by label or provider.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next` | string | No | Cursor to fetch the next page of results. |
| `prev` | string | No | Cursor to fetch the previous page of results. |
| `label` | string | No | Filter integrations by label. |
| `limit` | integer | No | Maximum number of integrations to return per page (1-250). |
| `provider` | string ("AIPRISE" | "DOCUSIGN" | "INTERCOM" | "HMAC" | "BASIC_AUTH" | "API_KEY" | "MANAGED" | "HOOKDECK_OUTPOST" | "SANITY" | "BIGCOMMERCE" | "OPENAI" | "POLAR" | "BRIDGE" | "CHARGEBEE_BILLING" | "CLOUDSIGNAL" | "COINBASE" | "COURIER" | "CURSOR" | "MERAKI" | "FIREBLOCKS" | "FRONTAPP" | "ZOOM" | "TWITTER" | "RECHARGE" | "RECURLY" | "RING_CENTRAL" | "STRIPE" | "PROPERTY-FINDER" | "QUOTER" | "SHOPIFY" | "TWILIO" | "GITHUB" | "POSTMARK" | "TALLY" | "TYPEFORM" | "PICQER" | "XERO" | "SVIX" | "RESEND" | "ADYEN" | "AKENEO" | "GITLAB" | "WOOCOMMERCE" | "OKTA" | "OURA" | "COMMERCELAYER" | "HUBSPOT" | "MAILGUN" | "PERSONA" | "PIPEDRIVE" | "SENDGRID" | "WORKOS" | "SYNCTERA" | "AWS_SNS" | "THREE_D_EYE" | "TWITCH" | "ENODE" | "FAVRO" | "LINEAR" | "SHOPLINE" | "WIX" | "NMI" | "ORB" | "PYLON" | "RAZORPAY" | "REPAY" | "SQUARE" | "SOLIDGATE" | "TRELLO" | "EBAY" | "TELNYX" | "DISCORD" | "TOKENIO" | "FISERV" | "FUSIONAUTH" | "BONDSMITH" | "VERCEL_LOG_DRAINS" | "VERCEL" | "TEBEX" | "SLACK" | "SMARTCAR" | "MAILCHIMP" | "NUVEMSHOP" | "PADDLE" | "PAYPAL" | "PORTAL" | "TREEZOR" | "PRAXIS" | "CUSTOMERIO" | "EXACT_ONLINE" | "FACEBOOK" | "WHATSAPP" | "REPLICATE" | "TIKTOK" | "TIKTOK_SHOP" | "AIRWALLEX" | "ASCEND" | "ALIPAY" | "ZENDESK" | "UPOLLO" | "SMILE" | "NYLAS" | "CLIO" | "GOCARDLESS" | "LINKEDIN" | "LITHIC" | "UTILA" | "ZEROHASH" | "AIRTABLE" | "ASANA" | "FASTSPRING" | "PAYPRO_GLOBAL" | "USPS" | "FLEXPORT") | No | Supported integration providers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Issue Count

**Slug:** `HOOKDECK_GET_ISSUE_COUNT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more issue IDs. |
| `dir` | string ("asc" | "desc") | No | Sort direction: asc or desc. |
| `next` | string | No | Cursor for next page of results. |
| `prev` | string | No | Cursor for previous page of results. |
| `type` | string | No | Filter by issue types: delivery, transformation, backpressure. |
| `limit` | integer | No | Page size for pagination (1-250). |
| `status` | string | No | Filter by issue statuses: OPENED, IGNORED, ACKNOWLEDGED, RESOLVED. |
| `order_by` | string | No | Sort key(s). |
| `created_at` | object | No | Filter by creation timestamp using operators (gte, gt, lte, lt). |
| `merged_with` | string | No | Filter by one or more merged issue IDs. |
| `dismissed_at` | object | No | Filter by dismissed timestamp using operators (gte, gt, lte, lt). |
| `last_seen_at` | object | No | Filter by last seen timestamp using operators (gte, gt, lte, lt). |
| `first_seen_at` | object | No | Filter by first seen timestamp using operators (gte, gt, lte, lt). |
| `aggregation_keys` | object | No | Filter by aggregation keys as a JSON object. |
| `issue_trigger_id` | string | No | Filter by one or more issue trigger IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Issue Trigger

**Slug:** `HOOKDECK_GET_ISSUE_TRIGGER`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the issue trigger to retrieve. Issue trigger IDs start with 'it_' prefix (e.g., 'it_GpSukz3t969g2g'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get issue triggers

**Slug:** `HOOKDECK_GET_ISSUE_TRIGGERS`

Tool to list issue triggers for your Hookdeck account. Use when you need to retrieve configured issue triggers and their notification settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dir` | string | No | Sort direction: asc or desc. |
| `name` | string | No | Filter by issue trigger name. |
| `next` | string | No | The ID to provide in the query to get the next set of results. |
| `prev` | string | No | The ID to provide in the query to get the previous set of results. |
| `type` | string | No | Filter by issue trigger type. |
| `limit` | integer | No | Result set size (1-250). Default: 100. |
| `order_by` | string | No | Sort key for the results. |
| `disabled_at` | string | No | Date when the issue trigger was disabled (ISO 8601 format). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Queue Depth Metrics

**Slug:** `HOOKDECK_GET_QUEUE_DEPTH_METRICS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Filter criteria for the metrics query (e.g., filter by destination ID or other dimensions). |
| `measures` | array | Yes | Metrics to calculate. Must be one or more of: max_depth (pending events count), max_age (age of oldest pending event). At least one measure is required. |
| `date_range` | object | Yes | Date range with start and end timestamps in ISO 8601 format. Required for the query. |
| `dimensions` | array | No | Dimensions to group metrics by (e.g., 'destination_id', 'source_id'). Results will be grouped by these dimensions. |
| `granularity` | string | No | Time bucket granularity. Format: <number><unit> where unit is: s (seconds 1-60), m (minutes 1-60), h (hours 1-24), d (days 1-31), w (weeks 1-4), M (months 1-12). If not specified, API defaults to single bucket for entire range. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Request

**Slug:** `HOOKDECK_GET_REQUEST`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | ID of the Hookdeck request to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Request Bulk Retries

**Slug:** `HOOKDECK_GET_REQUEST_BULK_RETRIES`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more bulk retry IDs. |
| `dir` | string | No | Sort direction for results: 'asc' for ascending or 'desc' for descending. |
| `next` | string | No | Cursor token to fetch the next page of results. Provided in pagination object of previous response. |
| `prev` | string | No | Cursor token to fetch the previous page of results. Provided in pagination object of previous response. |
| `limit` | integer | No | Maximum number of results to return per page. |
| `query` | object | No | Filter properties for the requests to be included in the bulk retry, using query parameters of Requests endpoint (e.g., status, source_id, verified). |
| `order_by` | string | No | Sort key for results. Common values: 'created_at', 'updated_at'. |
| `created_at` | string | No | Filter by date the bulk retry was created. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `in_progress` | boolean | No | Filter by whether the bulk retry is currently in progress. True for running operations, false for completed or cancelled. |
| `cancelled_at` | string | No | Filter by date the bulk retry was cancelled. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `completed_at` | string | No | Filter by date the bulk retry completed. Can be an ISO-8601 timestamp or an object with operators (gte, lte, gt, lt). |
| `query_partial_match` | boolean | No | Allow partial filter match on query property. When true, relaxes exact matching requirements. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Request Bulk Retry Status

**Slug:** `HOOKDECK_GET_REQUEST_BULK_RETRY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Bulk retry ID to retrieve (e.g., 'bch_NEDn7bKfOOcurI') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Request Events

**Slug:** `HOOKDECK_GET_REQUEST_EVENTS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Request ID to retrieve events for |
| `dir` | string ("asc" | "desc") | No | Sort direction |
| `body` | string | No | URL Encoded string of the JSON to match to the data body |
| `next` | string | No | The ID to provide in the query to get the next set of results |
| `path` | string | No | URL Encoded string of the value to match partially to the path |
| `prev` | string | No | The ID to provide in the query to get the previous set of results |
| `limit` | integer | No | Result set size |
| `cli_id` | string | No | Filter by CLI IDs. `?[any]=true` operator for any CLI. |
| `status` | string | No | Filter by lifecycle status of the event |
| `headers` | string | No | URL Encoded string of the JSON to match to the data headers |
| `include` | string | No | Include the data object in the event model |
| `attempts` | string | No | Filter by number of attempts |
| `issue_id` | string | No | Filter by issue ID |
| `order_by` | string | No | Sort key |
| `source_id` | string | No | Filter by source IDs |
| `created_at` | string | No | Filter by `created_at` date using a date operator |
| `error_code` | string | No | Filter by error code |
| `webhook_id` | string | No | Filter by connection (webhook) IDs |
| `cli_user_id` | string | No | Filter by CLI user ID |
| `parsed_query` | string | No | URL Encoded string of the JSON to match to the parsed query (JSON representation of the query) |
| `bulk_retry_id` | string | No | Filter by bulk retry ID |
| `event_data_id` | string | No | Filter by event data ID |
| `successful_at` | string | No | Filter by `successful_at` date using a date operator |
| `destination_id` | string | No | Filter by destination IDs |
| `last_attempt_at` | string | No | Filter by `last_attempt_at` date using a date operator |
| `next_attempt_at` | string | No | Filter by `next_attempt_at` date using a date operator |
| `response_status` | string | No | Filter by HTTP response status code |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Request Ignored Events

**Slug:** `HOOKDECK_GET_REQUEST_IGNORED_EVENTS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Request ID to retrieve ignored events for |
| `dir` | string | No | Sort direction(s) for the response |
| `next` | string | No | The ID to provide in the query to get the next set of results |
| `prev` | string | No | The ID to provide in the query to get the previous set of results |
| `limit` | integer | No | Result set size for pagination |
| `order_by` | string | No | Sort key(s) for the response |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Request Raw Body

**Slug:** `HOOKDECK_GET_REQUEST_RAW_BODY`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Request ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Hookdeck: Get Requests

**Slug:** `HOOKDECK_GET_REQUESTS`

Tool to list Hookdeck requests. Use when you need to retrieve requests with optional filters and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more request IDs. |
| `dir` | string ("asc" | "desc") | No | Sort direction (asc or desc). |
| `body` | object | No | Partial JSON match against request body. |
| `next` | string | No | Cursor for next page of results. |
| `path` | string | No | Partial string match against the request path. |
| `prev` | string | No | Cursor for previous page of results. |
| `limit` | integer | No | Page size (1-255). |
| `status` | string ("accepted" | "rejected") | No | Filter by request status. |
| `headers` | object | No | Partial JSON match against request headers. |
| `order_by` | string ("ingested_at" | "created_at") | No | Sort key for results. |
| `verified` | boolean | No | Filter by whether the request was verified. |
| `source_id` | string | No | Filter by one or more source IDs. |
| `ingested_at` | string | No | Filter by request ingestion timestamp. Accepts ISO-8601 string or operators dict like {'gte': '2023-01-01T00:00:00Z'}. |
| `events_count` | string | No | Filter by number of events created (excluding CLI events). Accepts integer, list, or operators dict. |
| `parsed_query` | object | No | Partial JSON match against parsed query parameters. |
| `ignored_count` | string | No | Filter by ignored events count. Accepts a single integer, list of integers, or operators dict like {'gte': 5}. |
| `rejection_cause` | string | No | Filter by one or more rejection causes. |
| `cli_events_count` | string | No | Filter by number of CLI events created. Accepts integer, list, or operators dict. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get requests metrics

**Slug:** `HOOKDECK_GET_REQUESTS_METRICS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Additional filters to apply to the metrics query |
| `measures` | array | Yes | Metrics to calculate (e.g., 'count') |
| `date_range` | object | Yes | Date range with start and end timestamps in ISO 8601 format |
| `dimensions` | array | No | Dimensions to group metrics by |
| `granularity` | string | No | Time bucket granularity. Format: <number><unit> where unit is s (seconds 1-60), m (minutes 1-60), h (hours 1-24), d (days 1-31), w (weeks 1-4), M (months 1-12). Examples: '1s', '5m', '1h', '1d' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Source

**Slug:** `HOOKDECK_GET_SOURCE`

Tool to retrieve details of a specific Hookdeck source. Use after confirming the source ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | string | No | Optional include parameter. Use 'config.auth' to include authentication credentials in the response config object. |
| `source_id` | string | Yes | ID of the source to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get sources

**Slug:** `HOOKDECK_GET_SOURCES`

Tool to retrieve all sources associated with your Hookdeck account. Use when you need to list or filter hook sources.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by source IDs. |
| `dir` | string ("asc" | "desc") | No | Sort direction used in the response; defaults to desc if omitted. |
| `name` | string | No | Filter by source name; supports string operators such as contains. |
| `next` | string | No | ID to get the next page of results. Value must come from the previous response's pagination cursor, not constructed manually. |
| `prev` | string | No | ID to get the previous page of results. |
| `type` | string | No | Filter by source type. |
| `limit` | integer | No | Result set size (max 255). |
| `disabled` | boolean | No | Include disabled resources in the response. |
| `order_by` | string ("name" | "created_at" | "updated_at") | No | Sort key used in the response; defaults to created_at if omitted. |
| `disabled_at` | object | No | Filter by date disabled; use operators gte, gt, lte, lt, e.g., {'gte': '2021-01-01'}. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hookdeck Transformation

**Slug:** `HOOKDECK_GET_TRANSFORMATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transformation_id` | string | Yes | The unique identifier of the transformation to retrieve. Transformation IDs start with 'trs_' prefix (e.g., 'trs_abc123def456'). Use HOOKDECK_GET_TRANSFORMATIONS to list available transformation IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transformation Execution

**Slug:** `HOOKDECK_GET_TRANSFORMATION_EXECUTION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `execution_id` | string | Yes | The unique identifier of the transformation execution (starts with 'reqt_' prefix, e.g., 'reqt_RPezSv8BLk9n0Tl5fK'). |
| `transformation_id` | string | Yes | The unique identifier of the transformation (starts with 'trs_' prefix, e.g., 'trs_wewrYkuM4iXJeh'). Use HOOKDECK_GET_TRANSFORMATIONS to list available transformation IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get transformation executions

**Slug:** `HOOKDECK_GET_TRANSFORMATION_EXECUTIONS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Transformation ID to retrieve executions for. Must be a valid transformation ID (starts with 'trs_' prefix). |
| `dir` | string | No | Sort direction(s) - 'asc' for ascending or 'desc' for descending. |
| `next` | string | No | Cursor for fetching the next page of results. |
| `prev` | string | No | Cursor for fetching the previous page of results. |
| `limit` | integer | No | Result set size - maximum number of results per page. |
| `issue_id` | string | No | Filter by associated issue ID. |
| `order_by` | string | No | Sort key(s) for ordering results (e.g., 'created_at'). |
| `log_level` | string | No | Filter by log level of the execution (e.g., 'info', 'warn', 'error'). |
| `created_at` | string | No | Filter by ISO date of the transformation's execution (e.g., '2025-01-01T00:00:00Z'). |
| `webhook_id` | string | No | Filter by connection (webhook) ID that the execution was run for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get transformations

**Slug:** `HOOKDECK_GET_TRANSFORMATIONS`

Tool to list Hookdeck transformations. Use when you need to retrieve or filter your Hookdeck transformations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by transformation IDs. |
| `dir` | string ("asc" | "desc") | No | Sort direction used for this response. |
| `name` | string | No | Filter by transformation name; supports string operators such as contains. |
| `next` | string | No | Cursor for next page of results. |
| `prev` | string | No | Cursor for previous page of results. |
| `limit` | integer | No | Page size; maximum of 255. |
| `order_by` | string ("name" | "created_at" | "updated_at") | No | Sort key used for this response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transformations Count

**Slug:** `HOOKDECK_GET_TRANSFORMATIONS_COUNT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by transformation IDs. |
| `name` | string | No | Filter by transformation name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get transformations metrics

**Slug:** `HOOKDECK_GET_TRANSFORMATIONS_METRICS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Additional filters to apply to the metrics query |
| `measures` | array | Yes | Metrics to calculate (e.g., 'count') |
| `date_range` | object | Yes | Date range with start and end timestamps in ISO 8601 format |
| `dimensions` | array | No | Dimensions to group metrics by |
| `granularity` | string | No | Time bucket granularity. Format: <number><unit> where unit is s (seconds 1-60), m (minutes 1-60), h (hours 1-24), d (days 1-31), w (weeks 1-4), M (months 1-12). Examples: '1s', '5m', '1h', '1d' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Hookdeck Bookmarks

**Slug:** `HOOKDECK_LIST_BOOKMARKS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more bookmark IDs (prefixed with 'bmk_') |
| `dir` | string ("asc" | "desc") | No | Sort direction: 'asc' or 'desc' |
| `next` | string | No | Cursor for next page |
| `prev` | string | No | Cursor for previous page |
| `label` | string | No | Filter by bookmark label (the descriptive name given to the bookmark) |
| `limit` | integer | No | Page size limit (1-255) |
| `order_by` | string | No | Field to order by, e.g., 'created_at' or 'last_used_at' |
| `webhook_id` | string | No | Filter by one or more connection IDs (prefixed with 'web_') |
| `event_data_id` | string | No | Filter by one or more event data IDs (prefixed with 'edt_') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Custom Domains

**Slug:** `HOOKDECK_LIST_CUSTOM_DOMAINS`

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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Hookdeck: List Issues

**Slug:** `HOOKDECK_LIST_ISSUES`

Tool to list all issues detected in your Hookdeck account. Use when you need to retrieve and filter issues by type, status, or time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by one or more issue IDs. |
| `dir` | string ("asc" | "desc") | No | Sort direction: asc or desc. |
| `next` | string | No | Cursor for next page of results. |
| `prev` | string | No | Cursor for previous page of results. |
| `type` | string | No | Filter by issue types: delivery, transformation, backpressure. |
| `limit` | integer | No | Page size for pagination (1-250). |
| `status` | string | No | Filter by issue statuses: OPENED, IGNORED, ACKNOWLEDGED, RESOLVED. |
| `order_by` | string | No | Sort key(s). |
| `created_at` | object | No | Filter by creation timestamp using operators (gte, gt, lte, lt). |
| `merged_with` | string | No | Filter by one or more merged issue IDs. |
| `dismissed_at` | object | No | Filter by dismissed timestamp using operators (gte, gt, lte, lt). |
| `last_seen_at` | object | No | Filter by last seen timestamp using operators (gte, gt, lte, lt). |
| `first_seen_at` | object | No | Filter by first seen timestamp using operators (gte, gt, lte, lt). |
| `aggregation_keys` | object | No | Filter by aggregation keys as a JSON object. |
| `issue_trigger_id` | string | No | Filter by one or more issue trigger IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Hookdeck Pause Connection

**Slug:** `HOOKDECK_PAUSE_CONNECTION`

Tool to pause a Hookdeck connection. Use when you need to temporarily stop event delivery for a connection without deleting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the connection to pause. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Publish Event to Hookdeck

**Slug:** `HOOKDECK_PUBLISH_EVENT`

Tool to publish a webhook event to Hookdeck using the Publish API. Use when testing webhook flows or sending events from your application.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload` | object | Yes | JSON payload containing the event data to publish. Can include any fields like event_type, order_id, data, etc. This becomes the webhook body. |
| `source_name` | string | Yes | Name of the source to publish to. This will be passed in the X-Hookdeck-Source-Name header. The source must exist in your Hookdeck project. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replay Hookdeck Event

**Slug:** `HOOKDECK_REPLAY_EVENT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_id` | string | Yes | The unique identifier of the Hookdeck event to replay. Must be a valid event ID starting with 'evt_'. The event's connection must still be active. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve Hookdeck Issue

**Slug:** `HOOKDECK_RESOLVE_ISSUE`

Tool to resolve a Hookdeck issue. Use after confirming the underlying issue has been addressed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `issue_id` | string | Yes | ID of the issue to resolve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Hookdeck Issue

**Slug:** `HOOKDECK_RETRIEVE_ISSUE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `issue_id` | string | Yes | The unique identifier of the issue to retrieve. Issue IDs start with 'iss_' prefix (e.g., 'iss_abc123'). Use the List Issues action to find valid issue IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Hookdeck Source Request

**Slug:** `HOOKDECK_SEND_SOURCE_REQUEST`

Tool to send HTTP requests to a Hookdeck Source URL. Use when ingesting test payloads to generate events for testing HOOKDECK_GET_EVENT.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | No | Optional JSON-compatible payload for POST/PUT/PATCH requests; serialized as JSON. |
| `path` | string | No | Optional path appended after the source_id; must start with '/'. |
| `query` | object | No | Optional query parameters. Supports Hookdeck flags like x-hookdeck-allow-methods and x-hookdeck-response variants. |
| `method` | string ("GET" | "POST" | "PUT" | "PATCH" | "DELETE") | No | HTTP method to use. GET is allowed only if enabled in the Source settings or via the x-hookdeck-allow-methods query parameter. |
| `headers` | object | No | Optional headers to include; do not include Hookdeck REST API auth headers. |
| `source_id` | string | Yes | The unique URL segment from the source's ingest URL (e.g., 'aj3f7wm89u1enh' from 'https://hkdk.events/aj3f7wm89u1enh'). Obtain this from HOOKDECK_GET_SOURCES or HOOKDECK_GET_SOURCE by extracting the last path segment from the 'url' field. This is NOT the source's internal ID (src_xxx). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test Hookdeck Transformation

**Slug:** `HOOKDECK_TEST_TRANSFORMATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `env` | object | No | Key-value environment variables to be passed to the transformation during execution. |
| `code` | string | Yes | JavaScript code to be executed for testing. Must use addHandler('transform', (request, context) => { ... }) syntax. The handler receives request (with headers, body, query, parsed_query, path) and context parameters. |
| `request` | object | Yes | Request input to use for the transformation execution. Must include at minimum the headers field. |
| `event_id` | string | No | Optional event ID to use for the test execution context. |
| `webhook_id` | string | No | ID of the connection (webhook) to use for the execution context. |
| `transformation_id` | string | No | Optional transformation ID to use for the test execution. If provided, the code from this transformation will be used instead of the code parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Toggle Webhook Notifications

**Slug:** `HOOKDECK_TOGGLE_WEBHOOK_NOTIFICATIONS`

Tool to toggle webhook notifications for the project. Use when you need to enable or disable webhook notifications and configure which topics to receive.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `topics` | array | Yes | List of notification topics to subscribe to. Available topics: issue.opened, issue.updated, deprecated.attempt-failed, event.successful. |
| `enabled` | boolean | Yes | Enable or disable webhook notifications on the project. Set to true to enable, false to disable. |
| `source_id` | string | Yes | The Hookdeck Source ID to send the webhook notifications to (e.g., 'src_1234567890abcdef'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Trigger Hookdeck Bookmark

**Slug:** `HOOKDECK_TRIGGER_BOOKMARK`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bookmark_id` | string | Yes | The unique identifier of the bookmark to trigger. This replays the stored webhook request associated with the bookmark, creating a new event. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | array | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unpause Hookdeck Connection

**Slug:** `HOOKDECK_UNPAUSE_CONNECTION`

Tool to unpause a paused Hookdeck connection. Use when you need to resume event processing for a previously paused connection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique ID of the connection to unpause (e.g., 'web_NvdMyXJDYXDr') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Hookdeck Bookmark

**Slug:** `HOOKDECK_UPDATE_BOOKMARK`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New unique, human-friendly name for the bookmark. Must contain only alphanumeric characters, hyphens, and underscores (pattern: ^[A-z0-9-_]+$). Maximum 155 characters. |
| `label` | string | No | New descriptive name for the bookmark shown in the Hookdeck UI and CLI. Maximum 255 characters. |
| `webhook_id` | string | No | New connection (webhook) ID to associate with this bookmark. Obtain from HOOKDECK_GET_CONNECTIONS. Maximum 255 characters. |
| `bookmark_id` | string | Yes | The unique identifier of the bookmark to update (prefixed with 'bmk_') |
| `event_data_id` | string | No | New event data ID to associate with this bookmark. Obtain from event objects via HOOKDECK_GET_EVENTS. Maximum 255 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Hookdeck Update Connection

**Slug:** `HOOKDECK_UPDATE_CONNECTION`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Unique name for the connection; alphanumeric with hyphens/underscores, max 155 chars |
| `rules` | array | No | Array of rules for the connection (e.g., retry, filter, transform, delay) |
| `source` | object | No | Source specification for the connection (by name or for inline creation). |
| `source_id` | string | No | ID of an existing source. Mutually exclusive with 'source'. |
| `description` | string | No | Human-readable description for the connection; max 500 chars |
| `destination` | object | No | Destination specification for the connection (by name or for inline creation). |
| `destination_id` | string | No | ID of an existing destination. Mutually exclusive with 'destination'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Connection by ID

**Slug:** `HOOKDECK_UPDATE_CONNECTION2`

Tool to update an existing Hookdeck connection by its ID. Use when you need to modify a connection's description, name, or rules.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Connection ID to update |
| `name` | string | No | Name for the connection; alphanumeric with hyphens/underscores, max 155 chars |
| `rules` | array | No | Array of rules configured on the connection (retry, filter, transform, delay, deduplicate) |
| `description` | string | No | Description for the connection |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Hookdeck Destination

**Slug:** `HOOKDECK_UPDATE_DESTINATION`

Tool to update an existing Hookdeck destination. Use when you need to modify a destination's settings after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the destination. Pattern: ^[A-Za-z0-9\-_]+$, max length 155 |
| `type` | string ("HTTP" | "CLI" | "MOCK_API") | No | Destination type |
| `config` | object | No | Configuration for a Hookdeck destination. |
| `description` | string | No | Description for the destination, max length 500 |
| `destination_id` | string | Yes | ID of the destination to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Hookdeck Integration

**Slug:** `HOOKDECK_UPDATE_INTEGRATION`

Tool to update an existing Hookdeck integration. Use when you need to modify integration configuration, change labels, update provider settings, or enable/disable features.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Integration ID to update |
| `label` | string | No | Label of the integration for easy identification. |
| `configs` | object | No | Decrypted key/value object of the associated configuration for the provider. Required fields vary by provider (e.g., 'api_key' for API_KEY provider, 'webhook_secret_key' for HMAC, 'username' and 'password' for BASIC_AUTH). |
| `features` | array | No | List of features to enable for this integration. |
| `provider` | string ("AIPRISE" | "DOCUSIGN" | "INTERCOM" | "HMAC" | "BASIC_AUTH" | "API_KEY" | "MANAGED" | "HOOKDECK_OUTPOST" | "SANITY" | "BIGCOMMERCE" | "OPENAI" | "POLAR" | "BRIDGE" | "CHARGEBEE_BILLING" | "CLOUDSIGNAL" | "COINBASE" | "COURIER" | "CURSOR" | "MERAKI" | "FIREBLOCKS" | "FRONTAPP" | "ZOOM" | "TWITTER" | "RECHARGE" | "RECURLY" | "RING_CENTRAL" | "STRIPE" | "PROPERTY-FINDER" | "QUOTER" | "SHOPIFY" | "TWILIO" | "GITHUB" | "POSTMARK" | "TALLY" | "TYPEFORM" | "PICQER" | "XERO" | "SVIX" | "RESEND" | "ADYEN" | "AKENEO" | "GITLAB" | "WOOCOMMERCE" | "OKTA" | "OURA" | "COMMERCELAYER" | "HUBSPOT" | "MAILGUN" | "PERSONA" | "PIPEDRIVE" | "SENDGRID" | "WORKOS" | "SYNCTERA" | "AWS_SNS" | "THREE_D_EYE" | "TWITCH" | "ENODE" | "FAVRO" | "LINEAR" | "SHOPLINE" | "WIX" | "NMI" | "ORB" | "PYLON" | "RAZORPAY" | "REPAY" | "SQUARE" | "SOLIDGATE" | "TRELLO" | "EBAY" | "TELNYX" | "DISCORD" | "TOKENIO" | "FISERV" | "FUSIONAUTH" | "BONDSMITH" | "VERCEL_LOG_DRAINS" | "VERCEL" | "TEBEX" | "SLACK" | "SMARTCAR" | "MAILCHIMP" | "NUVEMSHOP" | "PADDLE" | "PAYPAL" | "PORTAL" | "TREEZOR" | "PRAXIS" | "CUSTOMERIO" | "EXACT_ONLINE" | "FACEBOOK" | "WHATSAPP" | "REPLICATE" | "TIKTOK" | "TIKTOK_SHOP" | "AIRWALLEX" | "ASCEND" | "ALIPAY" | "ZENDESK" | "UPOLLO" | "SMILE" | "NYLAS" | "CLIO" | "GOCARDLESS" | "LINKEDIN" | "LITHIC" | "UTILA" | "ZEROHASH" | "AIRTABLE" | "ASANA" | "FASTSPRING" | "PAYPRO_GLOBAL" | "USPS" | "FLEXPORT") | No | Supported integration providers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Hookdeck Issue Trigger

**Slug:** `HOOKDECK_UPDATE_ISSUE_TRIGGER`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Issue trigger ID to update. Obtain this from list issue triggers endpoint. |
| `name` | string | No | Optional unique name to reference the issue trigger via API. |
| `configs` | object | No | Configuration object based on issue type. For delivery: {strategy: 'first_attempt', connections: '*'}. For transformation: {log_level: 'error', transformations: '*'}. For backpressure: {delay: 1000, destinations: '*'}. |
| `channels` | object | No | Notification channels configuration. At least one channel must be specified. |
| `disabled_at` | string | No | ISO timestamp for when the issue trigger was disabled. Set to null to enable. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Hookdeck Source

**Slug:** `HOOKDECK_UPDATE_SOURCE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New unique name for the source. Must contain only alphanumeric characters, hyphens, and underscores (pattern: ^[A-Za-z0-9-_]+$). Maximum 155 characters. |
| `type` | string ("ADYEN" | "AIPRISE" | "AIRWALLEX" | "AKENEO" | "ALIPAY" | "AWS_SNS" | "BIGCOMMERCE" | "BONDSMITH" | "BRIDGE" | "CLIO" | "CLOUDSIGNAL" | "COMMERCELAYER" | "COURIER" | "CUSTOMERIO" | "DISCORD" | "DOCUSIGN" | "EBAY" | "ENODE" | "EXACT_ONLINE" | "FACEBOOK" | "FAVRO" | "FIREBLOCKS" | "FISERV" | "FRONTAPP" | "GITHUB" | "GITLAB" | "GOCARDLESS" | "HTTP" | "HUBSPOT" | "INTERCOM" | "LINEAR" | "LINKEDIN" | "MAILCHIMP" | "MAILGUN" | "MANAGED" | "MERAKI" | "MONDAY" | "NMI" | "NUVEMSHOP" | "NYLAS" | "OKTA" | "OPENAI" | "ORB" | "OURA" | "PADDLE" | "PAYPAL" | "PERSONA" | "PICQER" | "PIPEDRIVE" | "POLAR" | "POSTMARK" | "PRAXIS" | "PROPERTY-FINDER" | "PUBLISH_API" | "PYLON" | "QUOTER" | "RAZORPAY" | "RECHARGE" | "REPAY" | "REPLICATE" | "RING_CENTRAL" | "SANITY" | "SENDGRID" | "SHOPIFY" | "SHOPLINE" | "SLACK" | "SMILE" | "SOLIDGATE" | "SQUARE" | "STRAVA" | "STRIPE" | "SVIX" | "SYNCTERA" | "TALLY" | "TEBEX" | "TELNYX" | "THREE_D_EYE" | "TIKTOK" | "TIKTOK_SHOP" | "TOKENIO" | "TREEZOR" | "TRELLO" | "TWILIO" | "TWITCH" | "TWITTER" | "TYPEFORM" | "UPOLLO" | "UTILA" | "VERCEL" | "VERCEL_LOG_DRAINS" | "WEBHOOK" | "WHATSAPP" | "WIX" | "WOOCOMMERCE" | "WORKOS" | "XERO" | "ZENDESK" | "ZEROHASH" | "ZIFT" | "ZOOM") | No | New source type. Changing the type updates the source's expected webhook format and verification method. Common types: WEBHOOK (generic), STRIPE, GITHUB, SHOPIFY, etc. |
| `source_id` | string | Yes | The unique identifier of the source to update (e.g., 'src_1234567890abcdef'). Required. |
| `description` | string | No | New human-readable description for the source. Maximum 500 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Hookdeck Transformation

**Slug:** `HOOKDECK_UPDATE_TRANSFORMATION`

Tool to update an existing Hookdeck transformation. Use when you need to modify a transformation's code, name, or environment variables after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `env` | object | No | Environment variables for the transformation as string key-value pairs. |
| `code` | string | No | JavaScript code to be executed in the transformation. Use addHandler('transform', (request, context) => { ... }) syntax. |
| `name` | string | No | A unique, human-friendly name for the transformation. Must match pattern ^[A-Za-z0-9\-_]+$ and be at most 155 characters. |
| `transformation_id` | string | Yes | ID of the transformation to update (starts with 'trs_') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Hookdeck Destination

**Slug:** `HOOKDECK_UPSERT_DESTINATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Unique destination name; letters, numbers, hyphens, or underscores only; max 155 chars. |
| `type` | string ("HTTP" | "CLI" | "MOCK_API") | No | Destination type; one of HTTP, CLI, or MOCK_API. Defaults to HTTP. |
| `config` | object | No | Configuration object for the destination; fields vary by destination type. |
| `description` | string | No | Human-readable description of the destination; max 500 chars. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Hookdeck Issue Trigger

**Slug:** `HOOKDECK_UPSERT_ISSUE_TRIGGER`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Required unique name to reference the issue trigger via API. Used to identify the trigger for upsert operations. |
| `type` | string ("delivery" | "transformation" | "backpressure") | Yes | Issue type: 'delivery', 'transformation', or 'backpressure'. |
| `configs` | object | No | Configuration object based on issue type. For delivery: {strategy: 'first_attempt', connections: '*'}. For transformation: {log_level: 'error', transformations: []}. For backpressure: {delay: 1000, destinations: '*'}. |
| `channels` | object | Yes | Notification channels configuration. At least one channel must be specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Hookdeck Source

**Slug:** `HOOKDECK_UPSERT_SOURCE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Unique name for the source. Must contain only alphanumeric characters, hyphens, and underscores. Maximum 155 characters. If a source with this name exists, it will be updated; otherwise, a new source is created. |
| `type` | string ("AIPRISE" | "DOCUSIGN" | "INTERCOM" | "PUBLISH_API" | "WEBHOOK" | "HTTP" | "MANAGED" | "HOOKDECK_OUTPOST" | "SANITY" | "BIGCOMMERCE" | "OPENAI" | "POLAR" | "BRIDGE" | "CHARGEBEE_BILLING" | "CLOUDSIGNAL" | "COINBASE" | "COURIER" | "CURSOR" | "MERAKI" | "FIREBLOCKS" | "FRONTAPP" | "ZOOM" | "TWITTER" | "RECHARGE" | "RECURLY" | "RING_CENTRAL" | "STRIPE" | "PROPERTY-FINDER" | "QUOTER" | "SHOPIFY" | "TWILIO" | "GITHUB" | "POSTMARK" | "TALLY" | "TYPEFORM" | "PICQER" | "XERO" | "SVIX" | "RESEND" | "ADYEN" | "AKENEO" | "GITLAB" | "WOOCOMMERCE" | "OKTA" | "OURA" | "COMMERCELAYER" | "HUBSPOT" | "MAILGUN" | "PERSONA" | "PIPEDRIVE" | "SENDGRID" | "WORKOS" | "SYNCTERA" | "AWS_SNS" | "THREE_D_EYE" | "TWITCH" | "ENODE" | "FAVRO" | "LINEAR" | "SHOPLINE" | "WIX" | "NMI" | "ORB" | "PYLON" | "RAZORPAY" | "REPAY" | "SQUARE" | "SOLIDGATE" | "TRELLO" | "EBAY" | "TELNYX" | "DISCORD" | "TOKENIO" | "FISERV" | "FUSIONAUTH" | "BONDSMITH" | "VERCEL_LOG_DRAINS" | "VERCEL" | "TEBEX" | "SLACK" | "SMARTCAR" | "MAILCHIMP" | "NUVEMSHOP" | "PADDLE" | "PAYPAL" | "PORTAL" | "TREEZOR" | "PRAXIS" | "CUSTOMERIO" | "EXACT_ONLINE" | "FACEBOOK" | "WHATSAPP" | "REPLICATE" | "TIKTOK" | "TIKTOK_SHOP" | "AIRWALLEX" | "ASCEND" | "ALIPAY" | "ZENDESK" | "UPOLLO" | "SMILE" | "NYLAS" | "CLIO" | "GOCARDLESS" | "LINKEDIN" | "LITHIC" | "STRAVA" | "UTILA" | "MONDAY" | "ZEROHASH" | "ZIFT" | "ETHOCA" | "AIRTABLE" | "ASANA" | "FASTSPRING" | "PAYPRO_GLOBAL" | "USPS" | "FLEXPORT") | No | Type of the source. Defaults to 'WEBHOOK' for generic webhooks. Common types include STRIPE, GITHUB, SHOPIFY, etc. |
| `config` | object | No | Configuration object for the source; structure varies by source type. |
| `description` | string | No | Human-readable description of the source. Maximum 500 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert Hookdeck Transformation

**Slug:** `HOOKDECK_UPSERT_TRANSFORMATION`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `env` | object | No | Key-value environment variables to pass to the transformation code at runtime. |
| `code` | string | Yes | JavaScript code to be executed in the transformation. The code transforms webhook payloads before delivery. |
| `name` | string | Yes | A unique, human-friendly name for the transformation. Must match pattern ^[A-Za-z0-9\-_]+$ and be at most 155 characters. If a transformation with this name exists, it will be updated; otherwise, a new one will be created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
