All integrations

Hookdeck

DEVELOPER · DEVELOPER

Sources, destinations and the events routed between them in their own project.

Connecting Hookdeck in practice

Hookdeck’s REST API allows 240 requests a minute per API key, but the limit that actually shapes an integration is delivery throughput: 5 events per second per project on the Developer plan, with a 10 MiB inbound payload cap and a 2.5 MB ceiling on what the dashboard can search inside. Anything larger is still stored and delivered — it just becomes invisible to the event filter.

Rate limits

  • REST API: 240 requests per minute per API key, with X-RateLimit-Remaining and X-RateLimit-Reset (an ISO timestamp) on every response.
  • Delivery throughput: 5 events per second, set per project rather than per organization, and self-service upgradeable by plan.
  • Inbound payload: 10 MiB, rejected with HTTP 413 above that. Searchable payload: 2.5 MB, not adjustable.
  • Automatic retries: 50 attempts, fixed. Delivery timeout: 60 seconds by default, configurable per destination up to 15 minutes.
  • List pagination: 100 results by default, 250 maximum, cursor-based via next and prev.

Worth knowing

  • Most limits apply organization-wide, but throughput is configured per project, so raising it for one project does nothing for the others.
  • Basic auth with the API key as username and an empty password still works but is deprecated; Bearer is the documented path.
  • Authorization: Bearer belongs on the REST and Publish APIs only — putting it on a Source URL is a documented mistake, because that header is how Hookdeck’s own inbound authentication is configured.
  • The OpenAPI schema is date-pinned (api.hookdeck.com/2026-09-01/openapi.json), so a generated SDK silently tracks whichever date was current when it was built.

Checked against Limits (2026-09-29), API reference (2026-09-29), Authentication (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

hookdeck_delete_bookmarks_by_idWRITE

Delete a bookmark via DELETE /bookmarks/{id}

api
hookdeck_delete_connections_by_idWRITE

Delete a connection via DELETE /connections/{id}

api
hookdeck_delete_destinations_by_idWRITE

Delete a destination via DELETE /destinations/{id}

api
hookdeck_delete_integrations_by_idWRITE

Delete an integration via DELETE /integrations/{id}

api
hookdeck_delete_issue_triggers_by_idWRITE

Delete an issue trigger via DELETE /issue-triggers/{id}

api
hookdeck_delete_issues_by_idWRITE

Dismiss an issue via DELETE /issues/{id}

api
hookdeck_delete_sources_by_idWRITE

Delete a source via DELETE /sources/{id}

api
hookdeck_delete_teams_current_custom_domains_by_domain_idWRITE

Removes a custom domain from the project via DELETE /teams/current/custom_domains/{domain_id}

api
hookdeck_delete_transformations_by_idWRITE

Delete a transformation via DELETE /transformations/{id}

api
hookdeck_get_attemptsREAD

Retrieve attempts via GET /attempts

api
hookdeck_get_attempts_by_idREAD

Retrieve an attempt via GET /attempts/{id}

api
hookdeck_get_bookmarksREAD

Retrieve bookmarks via GET /bookmarks

api
hookdeck_get_bookmarks_by_idREAD

Retrieve a bookmark via GET /bookmarks/{id}

api
hookdeck_get_bookmarks_by_id_raw_bodyREAD

Get a bookmark raw body data via GET /bookmarks/{id}/raw_body

api
hookdeck_get_bulk_events_cancelREAD

Retrieve events bulk cancels via GET /bulk/events/cancel

api
hookdeck_get_bulk_events_cancel_by_idREAD

Retrieve events bulk cancel via GET /bulk/events/cancel/{id}

api
hookdeck_get_bulk_events_cancel_planREAD

Generate events bulk cancel plan via GET /bulk/events/cancel/plan

api
hookdeck_get_bulk_events_retryREAD

Retrieve events bulk retries via GET /bulk/events/retry

api
hookdeck_get_bulk_events_retry_by_idREAD

Retrieve events bulk retry via GET /bulk/events/retry/{id}

api
hookdeck_get_bulk_events_retry_planREAD

Generate events bulk retry plan via GET /bulk/events/retry/plan

api
hookdeck_get_bulk_ignored_events_retryREAD

Retrieve ignored events bulk retries via GET /bulk/ignored-events/retry

api
hookdeck_get_bulk_ignored_events_retry_by_idREAD

Retrieve ignored events bulk retry via GET /bulk/ignored-events/retry/{id}

api
hookdeck_get_bulk_ignored_events_retry_planREAD

Generate ignored events bulk retry plan via GET /bulk/ignored-events/retry/plan

api
hookdeck_get_bulk_requests_replayREAD

Retrieve requests bulk replays via GET /bulk/requests/replay

api
hookdeck_get_bulk_requests_replay_by_idREAD

Retrieve requests bulk replay via GET /bulk/requests/replay/{id}

api
hookdeck_get_bulk_requests_replay_planREAD

Generate requests bulk replay plan via GET /bulk/requests/replay/plan

api
hookdeck_get_bulk_requests_retryREAD

Retrieve requests bulk retries via GET /bulk/requests/retry

api
hookdeck_get_bulk_requests_retry_by_idREAD

Retrieve requests bulk retry via GET /bulk/requests/retry/{id}

api
hookdeck_get_bulk_requests_retry_planREAD

Generate requests bulk retry plan via GET /bulk/requests/retry/plan

api
hookdeck_get_connectionsREAD

Retrieve connections via GET /connections

api
hookdeck_get_connections_by_idREAD

Retrieve a connection via GET /connections/{id}

api
hookdeck_get_connections_countREAD

Count connections via GET /connections/count

api
hookdeck_get_destinationsREAD

Retrieve destinations via GET /destinations

api
hookdeck_get_destinations_by_idREAD

Retrieve a destination via GET /destinations/{id}

api
hookdeck_get_destinations_countREAD

Count destinations via GET /destinations/count

api
hookdeck_get_eventsREAD

Retrieve events via GET /events

api
hookdeck_get_events_by_idREAD

Retrieve an event via GET /events/{id}

api
hookdeck_get_events_by_id_raw_bodyREAD

Get a event raw body data via GET /events/{id}/raw_body

api
hookdeck_get_integrationsREAD

Get integrations via GET /integrations

api
hookdeck_get_integrations_by_idREAD

Get an integration via GET /integrations/{id}

api
hookdeck_get_issue_triggersREAD

Retrieve issue triggers via GET /issue-triggers

api
hookdeck_get_issue_triggers_by_idREAD

Retrieve an issue trigger via GET /issue-triggers/{id}

api
hookdeck_get_issuesREAD

Retrieve issues via GET /issues

api
hookdeck_get_issues_by_idREAD

Retrieve an issue via GET /issues/{id}

api
hookdeck_get_issues_countREAD

Get the number of issues via GET /issues/count

api
hookdeck_get_metrics_attemptsREAD

Query attempt metrics via GET /metrics/attempts

api
hookdeck_get_metrics_eventsREAD

Query event metrics via GET /metrics/events

api
hookdeck_get_metrics_events_by_issueREAD

Query event metrics grouped by individual issue via GET /metrics/events-by-issue

api
hookdeck_get_metrics_events_pending_timeseriesREAD

Query events pending timeseries metrics via GET /metrics/events-pending-timeseries

api
hookdeck_get_metrics_queue_depthREAD

Query queue depth metrics via GET /metrics/queue-depth

api
hookdeck_get_metrics_requestsREAD

Query request metrics via GET /metrics/requests

api
hookdeck_get_metrics_transformationsREAD

Query transformation execution metrics via GET /metrics/transformations

api
hookdeck_get_requestsREAD

Retrieve requests via GET /requests

api
hookdeck_get_requests_by_idREAD

Retrieve a request via GET /requests/{id}

api
hookdeck_get_requests_by_id_eventsREAD

Retrieve request events via GET /requests/{id}/events

api
hookdeck_get_requests_by_id_ignored_eventsREAD

Retrieve request ignored events via GET /requests/{id}/ignored_events

api
hookdeck_get_requests_by_id_raw_bodyREAD

Get a request raw body data via GET /requests/{id}/raw_body

api
hookdeck_get_sourcesREAD

Retrieve sources via GET /sources

api
hookdeck_get_sources_by_idREAD

Retrieve a source via GET /sources/{id}

api
hookdeck_get_sources_countREAD

Count sources via GET /sources/count

api
hookdeck_get_teams_current_custom_domainsREAD

List all custom domains and their verification statuses for the project via GET /teams/current/custom_domains

api
hookdeck_get_transformationsREAD

Retrieve transformations via GET /transformations

api
hookdeck_get_transformations_by_idREAD

Retrieve a transformation via GET /transformations/{id}

api
hookdeck_get_transformations_by_id_executionsREAD

Get transformation executions via GET /transformations/{id}/executions

api
hookdeck_get_transformations_by_id_executions_by_execution_idREAD

Get a transformation execution via GET /transformations/{id}/executions/{execution_id}

api
hookdeck_get_transformations_countREAD

Get transformations count via GET /transformations/count

api
hookdeck_post_bookmarksWRITE

Create a bookmark via POST /bookmarks

api
hookdeck_post_bookmarks_by_id_triggerWRITE

Trigger a bookmark via POST /bookmarks/{id}/trigger

api
hookdeck_post_bulk_events_cancelWRITE

Create events bulk cancel via POST /bulk/events/cancel

api
hookdeck_post_bulk_events_retryWRITE

Create events bulk retry via POST /bulk/events/retry

api
hookdeck_post_bulk_events_retry_by_id_cancelWRITE

Cancel events bulk retry via POST /bulk/events/retry/{id}/cancel

api
hookdeck_post_bulk_ignored_events_retryWRITE

Create ignored events bulk retry via POST /bulk/ignored-events/retry

api
hookdeck_post_bulk_ignored_events_retry_by_id_cancelWRITE

Cancel ignored events bulk retry via POST /bulk/ignored-events/retry/{id}/cancel

api
hookdeck_post_bulk_requests_replayWRITE

Create requests bulk replay via POST /bulk/requests/replay

api
hookdeck_post_bulk_requests_replay_by_id_cancelWRITE

Cancel requests bulk replay via POST /bulk/requests/replay/{id}/cancel

api
hookdeck_post_bulk_requests_retryWRITE

Create requests bulk retry via POST /bulk/requests/retry

api
hookdeck_post_bulk_requests_retry_by_id_cancelWRITE

Cancel requests bulk retry via POST /bulk/requests/retry/{id}/cancel

api
hookdeck_post_connectionsWRITE

Create a connection via POST /connections

api
hookdeck_post_destinationsWRITE

Create a destination via POST /destinations

api
hookdeck_post_events_by_id_replayWRITE

Replay an event via POST /events/{id}/replay

api
hookdeck_post_events_by_id_retryWRITE

Retry an event via POST /events/{id}/retry

api
hookdeck_post_integrationsWRITE

Create an integration via POST /integrations

api
hookdeck_post_issue_triggersWRITE

Create an issue trigger via POST /issue-triggers

api
hookdeck_post_requests_by_id_replayWRITE

Replay a request via POST /requests/{id}/replay

api
hookdeck_post_requests_by_id_retryWRITE

Retry a request via POST /requests/{id}/retry

api
hookdeck_post_sourcesWRITE

Create a source via POST /sources

api
hookdeck_post_teams_current_custom_domainsWRITE

Add a custom domain to the project via POST /teams/current/custom_domains

api
hookdeck_post_transformationsWRITE

Create a transformation via POST /transformations

api
hookdeck_put_bookmarks_by_idWRITE

Update a bookmark via PUT /bookmarks/{id}

api
hookdeck_put_connectionsWRITE

Create/Update a connection via PUT /connections

api
hookdeck_put_connections_by_idWRITE

Update a connection via PUT /connections/{id}

api
hookdeck_put_connections_by_id_archiveWRITE

Disable a connection (archive) via PUT /connections/{id}/archive

api
hookdeck_put_connections_by_id_disableWRITE

Disable a connection (disable) via PUT /connections/{id}/disable

api
hookdeck_put_connections_by_id_enableWRITE

Enable a connection (enable) via PUT /connections/{id}/enable

api
hookdeck_put_connections_by_id_pauseWRITE

Pause a connection via PUT /connections/{id}/pause

api
hookdeck_put_connections_by_id_unarchiveWRITE

Enable a connection (unarchive) via PUT /connections/{id}/unarchive

api
hookdeck_put_connections_by_id_unpauseWRITE

Unpause a connection via PUT /connections/{id}/unpause

api
hookdeck_put_destinationsWRITE

Create/Update a destination via PUT /destinations

api
hookdeck_put_destinations_by_idWRITE

Update a destination via PUT /destinations/{id}

api
hookdeck_put_destinations_by_id_archiveWRITE

Disable a destination (archive) via PUT /destinations/{id}/archive

api
hookdeck_put_destinations_by_id_disableWRITE

Disable a destination (disable) via PUT /destinations/{id}/disable

api
hookdeck_put_destinations_by_id_enableWRITE

Enable a destination (enable) via PUT /destinations/{id}/enable

api
hookdeck_put_destinations_by_id_unarchiveWRITE

Enable a destination (unarchive) via PUT /destinations/{id}/unarchive

api
hookdeck_put_events_by_id_cancelWRITE

Cancel an event (cancel) via PUT /events/{id}/cancel

api
hookdeck_put_events_by_id_muteWRITE

Cancel an event (mute) via PUT /events/{id}/mute

api
hookdeck_put_integrations_by_idWRITE

Update an integration via PUT /integrations/{id}

api
hookdeck_put_integrations_by_id_attach_by_source_idWRITE

Attach an integration to a source via PUT /integrations/{id}/attach/{source_id}

api
hookdeck_put_integrations_by_id_detach_by_source_idWRITE

Detach an integration from a source via PUT /integrations/{id}/detach/{source_id}

api
hookdeck_put_issue_triggersWRITE

Create/Update an issue trigger via PUT /issue-triggers

api
hookdeck_put_issue_triggers_by_idWRITE

Update an issue trigger via PUT /issue-triggers/{id}

api
hookdeck_put_issue_triggers_by_id_disableWRITE

Disable an issue trigger via PUT /issue-triggers/{id}/disable

api
hookdeck_put_issue_triggers_by_id_enableWRITE

Enable an issue trigger via PUT /issue-triggers/{id}/enable

api
hookdeck_put_issues_by_idWRITE

Update an issue via PUT /issues/{id}

api
hookdeck_put_notifications_webhooksWRITE

Webhook Notifications via PUT /notifications/webhooks

api
hookdeck_put_sourcesWRITE

Create/Update a source via PUT /sources

api
hookdeck_put_sources_by_idWRITE

Update a source via PUT /sources/{id}

api
hookdeck_put_sources_by_id_archiveWRITE

Disable a source (archive) via PUT /sources/{id}/archive

api
hookdeck_put_sources_by_id_disableWRITE

Disable a source (disable) via PUT /sources/{id}/disable

api
hookdeck_put_sources_by_id_enableWRITE

Enable a source (enable) via PUT /sources/{id}/enable

api
hookdeck_put_sources_by_id_unarchiveWRITE

Enable a source (unarchive) via PUT /sources/{id}/unarchive

api
hookdeck_put_transformationsWRITE

Create/Update a transformation via PUT /transformations

api
hookdeck_put_transformations_by_idWRITE

Update a transformation via PUT /transformations/{id}

api
hookdeck_put_transformations_runWRITE

Test a transformation via PUT /transformations/run

api

Put Hookdeck behind one governed endpoint.

Same permissions, same audit trail, whatever else you connect next.