Quick Start — Webhook & HTTP Testing Toolkit API

1. Get your API key

Sign up on RapidAPI and subscribe to the Webhook & HTTP Testing Toolkit API.

2. Create a request bin

curl -X POST "https://webhook.toolkitapi.io/v1/bins" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-test", "ttl_seconds": 3600}'

import httpx

resp = httpx.post(
    "https://webhook.toolkitapi.io/v1/bins",
    headers={"X-API-Key": "YOUR_KEY"},
    json={"name": "my-test", "ttl_seconds": 3600},
)
print(resp.json()["bin"]["catch_url"])

const resp = await fetch(
  "https://webhook.toolkitapi.io/v1/bins",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": "YOUR_KEY",
    },
    body: JSON.stringify({
      name: "my-test",
      ttl_seconds: 3600,
    }),
  }
);
const data = await resp.json();
console.log(data.bin.catch_url);

3. Send a webhook to the catch URL

curl -X POST "https://webhook.toolkitapi.io/v1/catch/{bin_id}" \
  -H "Content-Type: application/json" \
  -d '{"event": "test.event", "data": {"key": "value"}}'

4. Inspect captured requests

curl "https://webhook.toolkitapi.io/v1/bins/{bin_id}/requests" \
  -H "X-API-Key: YOUR_KEY"

5. Create a mock endpoint

curl -X POST "https://webhook.toolkitapi.io/v1/mocks" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "error-stub", "status_code": 500, "body": "{\"error\": \"simulated\"}", "delay_ms": 1000}'