POST
1 credit
Create Request Bin
Create a temporary HTTP endpoint that captures and stores incoming requests
How to Use
- 1. Send a `POST` request to `/v1/bins` with your API key. 2. Optionally include a `name` and `ttl_seconds` in the JSON body. 3. The response includes a `catch_url` — use this as the target for your webhook or HTTP client.
About this Tool
Create a temporary HTTP request bin that captures every incoming request — headers, body, query strings, and metadata. The bin generates a unique catch URL that accepts any HTTP method, making it ideal for debugging webhooks and testing HTTP integrations.
All parameters are optional. Calling the endpoint with an empty body creates a bin with default settings (48-hour TTL, no name).
Use Cases
Quick webhook testing
Spin up a temporary endpoint in seconds to receive callbacks
CI/CD validation
Create ephemeral bins in test suites to verify outbound HTTP calls
Development prototyping
Stand up a capture endpoint without deploying any infrastructure
FAQ
Can I create a bin without any parameters? expand_more
Yes. A `POST` to `/v1/bins` with an empty body (or no body) creates a bin with a 48-hour TTL and no name.
What's the maximum TTL? expand_more
172,800 seconds (48 hours). The minimum is 60 seconds.
Is the catch URL private? expand_more
No. The catch URL (`/v1/catch/{bin_id}`) is public — no API key is required to send requests to it. Treat your `bin_id` and `catch_url` as sensitive values. Anyone who obtains them can send arbitrary requests into your bin. Avoid sharing them in logs, screenshots, or public channels.