To make the things discussed in the Webhooks Book more concrete, we provide a reference design of both the server-side and the client-side of webhooks. This design should not be understood as a dogmatic must-use. Instead, it should be used as an illustration of the concepts introduced before, as an inspiration and as a starting point for your own design.

The design is expressed in OpenAPI 3.0 API description language. In order to learn more about API description languages, check out the API Design Book.

Signup here to Download the Webhooks OpenAPI Specification: