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 Events API

List, retrieve, retry, mute, and inspect events and their delivery attempts. An event is any request Hookdeck received from a source; an attempt is each delivery try against a destination, including status, response body, response time, and error code.

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

This API exposes 2 JSON Schema definitions.

Tagged areas include Webhooks, Events, Attempts, and Event Gateways. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 2 JSON Schemas.

This API exposes 6 operations across 6 paths, and defines 11 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.

6 operations 6 paths 11 schemas 3 GET1 POST2 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 Events 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 6

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

Events 6

An event is any request that Hookdeck receives from a source.

GET
/events
Retrieve events
getEvents 29 params → 200400422
GET
/events/{id}
Retrieve an event
getEvent 1 param → 200404
GET
/events/{id}/raw_body
Get a event raw body data
getEventRawBody 1 param → 200404
POST
/events/{id}/retry
Retry an event
retryEvent 1 param → 200404
PUT
/events/{id}/cancel
Cancel an event
cancelEvent 1 param → 200404422
PUT
/events/{id}/mute
Cancel an event
cancelEvent_mute 1 param → 200404422

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are RetriedEvent (18 properties), Event (18 properties), EventData (9 properties), Operators (6 properties). Each schema is shown below with its type and property counts.

EventData
object
Event data if included
9 properties 7 required
EventStatus
string
Event
object
18 properties 15 required
APIErrorResponse
object
Error response model
4 properties 3 required
Operators
object
6 properties
OrderByDirection
RawBody
object
1 property 1 required
AttemptErrorCodes
string
Error code of the delivery attempt
EventPaginatedResult
object
3 properties
RetriedEvent
object
18 properties 15 required
SeekPagination
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hookdeck-events-api-openapi.yml Raw ↑

Other APIs Hookdeck publishes across the network.

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