Topic

Webhooks

4 min read

How to document webhooks in OpenAPI 3.1 (with signatures, retries, and examples)

Webhooks are reverse APIs: your server is the client, so the documentation has to cover payloads, delivery ordering, retries, signature verification, and endpoint registration. OpenAPI 3.1 made webhooks top-level citizens — here is a complete, consumer-ready webhook definition.

Read article