Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hookdeck Integrations API

Configure platform integrations that adapt Hookdeck behavior for specific source platforms — including signature verification, header normalization, allowed event types, and platform-aware retries (e.g., Stripe, GitHub, Twilio, Shopify, Linear).

Hookdeck Integrations API is one of 17 APIs that Hookdeck publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Integrations, Webhooks, and Event Gateways. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 7 operations across 4 paths, and defines 18 schemas. It is described by OpenAPI 3.0.1, at version 1.0.0.

Requests are made against a single base URL, https://api.hookdeck.com/2025-07-01.

7 operations 4 paths 18 schemas 1 DELETE2 GET1 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0.0
Base URL
https://api.hookdeck.com/2025-07-01
Authentication
HTTP Bearer, HTTP Basic
Resource Areas
1

Authentication & Security 2

Hookdeck Integrations API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 2 GET, 1 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Integrations 7

An integration configures platform-specific behaviors, such as signature verification.

GET
/integrations
Get integrations
getIntegrations 2 params → 200400422
POST
/integrations
Create an integration
createIntegration body → 200400422
GET
/integrations/{id}
Get an integration
getIntegration 1 param → 200404
PUT
/integrations/{id}
Update an integration
updateIntegration 1 param body → 200400404422
DELETE
/integrations/{id}
Delete an integration
deleteIntegration 1 param → 200404
PUT
/integrations/{id}/attach/{source_id}
Attach an integration to a source
attachIntegrationToSource 2 params → 200400404
PUT
/integrations/{id}/detach/{source_id}
Detach an integration from a source
detachIntegrationToSource 2 params → 200400404

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are Integration (9 properties), SeekPagination (5 properties), APIErrorResponse (4 properties), HMACIntegrationConfigs (4 properties). Each schema is shown below with its type and property counts.

BasicAuthIntegrationConfigs
object
2 properties 2 required
APIKeyIntegrationConfigs
object
2 properties 2 required
SeekPagination
object
5 properties
VercelLogDrainsIntegrationConfigs
object
2 properties 1 required
HandledAPIKeyIntegrationConfigs
object
1 property 1 required
HMACAlgorithms
string
DeletedIntegration
object
1 property 1 required
IntegrationProvider
string
HMACIntegrationConfigs
object
4 properties 4 required
IntegrationFeature
string
OrderByDirection
IntegrationPaginatedResult
object
3 properties
APIErrorResponse
object
Error response model
4 properties 3 required
DetachedIntegrationFromSource
object
HandledHMACConfigs
object
1 property 1 required
Integration
object
9 properties 9 required
ShopifyIntegrationConfigs
object
1 property 1 required
AttachedIntegrationToSource
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hookdeck-integrations-api-openapi.yml Raw ↑

Other APIs Hookdeck publishes across the network.

Hookdeck Connections API
Hookdeck Sources API
Hookdeck Destinations API
Hookdeck Events API
Hookdeck Requests API
Hookdeck Transformations API
Hookdeck Bookmarks API
Hookdeck Issues API
Hookdeck Metrics API
Hookdeck Notifications API
Hookdeck Attempts API
Hookdeck Bulk cancel events API