Skip to main content
The Webhooktrap REST API lets you integrate webhook capture and replay directly into your development workflow, CI pipeline, or automated test suite. Use it to spin up inboxes on demand, inspect every captured event in full detail, and forward those events to any destination — all without touching the dashboard.

​
Base URL

All API requests are made to the following base URL: 
https://api.webhooktrap.dev/api/v1

​
Response format

Every response from the API is JSON. Successful responses wrap the returned resource in a data envelope: 
{
  "data": {
    "<resource>": { ... }
  }
}
Errors use a separate error envelope and are accompanied by an appropriate HTTP status code: 
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Inbox not found"
  }
}

​
HTTP status codes

Status codeMeaning
200 OKThe request succeeded.
201 CreatedA new resource was successfully created.
400 Bad RequestThe request was malformed or contained invalid input.
401 UnauthorizedThe Authorization header is missing or the token is invalid.
404 Not FoundThe requested resource does not exist.
422 Unprocessable EntityThe request was well-formed but failed validation.
429 Too Many RequestsYou have exceeded the rate limit. Back off and retry.
500 Internal Server ErrorSomething went wrong on Webhooktrap’s side.

​
Authentication

Authenticated endpoints require a Bearer token passed in the Authorization header. Anonymous endpoints — such as creating an inbox — work without a token. See the Authentication page for full details on obtaining and using your API token.

​
Explore the API

Inboxes

Create a new webhook inbox and get an instant ingest URL.

Events

List all captured events for an inbox with full headers and body.

Replay

Forward any captured event to a destination URL and inspect the response.

Authentication

Learn how to obtain and use your API token.