API reference

hooksnode has two HTTP surfaces:

Surface	Base URL	Auth	Use it to
Ingest	`https://hooksnode.com/p/<source-id>`	None, or a source signature	Send events.
REST API v1	`https://hooksnode.com/api/v1`	Workspace API key	List projects, sources and events. Get the raw request. Retry. Stream live events.

Endpoints

Method	Path	Description
`POST`	`/p/{sourceId}`	Send an event
`GET`	`/api/v1/projects`	List projects
`GET`	`/api/v1/projects/{projectId}/sources`	List sources
`GET`	`/api/v1/projects/{projectId}/events`	List events
`GET`	`/api/v1/projects/{projectId}/events/{eventId}`	Get an event and its attempts
`GET`	`/api/v1/projects/{projectId}/events/{eventId}/request`	Get the raw request
`POST`	`/api/v1/projects/{projectId}/events/{eventId}/retry`	Retry the failed deliveries
`GET`	`/api/v1/projects/{projectId}/listen`	Stream live events (WebSocket)

Quick example

export HOOKSNODE_API_KEY=...

# Find your project
curl -s https://hooksnode.com/api/v1/projects \
  -H "Authorization: Bearer $HOOKSNODE_API_KEY" | jq '.[] | {id, name}'

# List its latest events
curl -s "https://hooksnode.com/api/v1/projects/<project-id>/events?page_size=5" \
  -H "Authorization: Bearer $HOOKSNODE_API_KEY"

Field names

All responses use snake_case. No response holds a signing secret, a password or a destination’s extra headers. A source or destination shows signing_enabled in place of its secret. Read secrets in the dashboard. In GET /api/v1/projects/{projectId}/events/{eventId}, event.payload is JSON, text or base64. event.payload_encoding tells you which. In attempts, the payload and header fields are base64. Each endpoint page shows the exact shape.

Other tools

The CLI uses this API to send live webhooks to your computer.
The dashboard uses a separate session-based API. It is not public and can change.

Overview

Ingest

Projects

Events

Streaming

Endpoints

Quick example

Field names

Other tools

​Endpoints

​Quick example

​Field names

​Other tools

Endpoints

Quick example

Field names

Other tools