API Reference Overview

The DiffHook REST API lets you programmatically create and manage monitors and query delivery logs. All endpoints return JSON, authenticate via bearer tokens, and respect per-plan rate limits with detailed error responses.

Base URL

https://www.diffhook.com

Authentication

All requests require a bearer token:

Authorization: Bearer JWTXYZ

Content type

Always include Content-Type: application/json on POST and PUT requests.

Resource types

Monitors — The core resource. A monitor represents a URL being watched, along with its configuration (interval, destination, selector).

Logs — Immutable records of webhook deliveries. Created automatically when a change is detected.

Timestamps

All timestamps are in ISO 8601 format in UTC:

2026-03-16T14:22:00Z

Pagination

List endpoints return up to 50 items by default. Use the limit query parameter to request up to 200.

HTTP status codes

Code	Meaning
200	OK
201	Created
204	No content (successful delete)
400	Bad request — check request body
401	Unauthorized — check API key
403	Forbidden — limit reached
404	Not found
429	Rate limited — slow down
500	Server error — contact support