Skip to content
POST AI agent ready /v1/webhook/inbox/create

Webhook Inbox API - Free Temporary Endpoint

Creates a unique webhook inbox with a receiving URL. Any POST request sent to the inbox URL is stored for 24 hours. Use the list endpoint to retrieve all captured payloads. Useful for testing third-party webhook integrations without deploying a server.

Code examples

curl -X POST https://api.botoi.com/v1/webhook/inbox/create \
  -H "Content-Type: application/json" \
  -d '{}'

When to use this API

Test Stripe or GitHub webhook payloads without deploying a server

Create an inbox, paste the URL into Stripe's webhook settings, and trigger a test event. Retrieve the captured payload to verify the structure before writing your handler code.

Debug failing webhook integrations in production

Point a failing webhook to a temporary inbox to capture the exact payload your provider sends. Compare it against your parser expectations to find the mismatch.

Frequently asked questions

How long do webhook inboxes last?
Each inbox and its captured payloads expire after 24 hours. There is no way to extend this window. For persistent storage, forward payloads to your own server.
How many payloads can one inbox capture?
An inbox stores up to 50 of the most recent payloads. If more arrive, the oldest are dropped. For high-volume testing, create multiple inboxes.
Can I send GET requests to the inbox URL?
No. The inbox receiving URL only accepts POST requests. GET requests return a 404. This matches the behavior of most webhook providers.
Is the inbox URL publicly accessible?
Yes. Anyone with the inbox URL can send payloads to it. The inbox ID is an 8-character random hex string, making it difficult to guess. Do not send sensitive production data to test inboxes.
Do I need an API key to create an inbox?
The endpoint works with anonymous access at 5 requests per minute (IP-based rate limiting). An API key removes the rate limit.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.