Postman collection
The collection calls https://webhookah.com. It creates an endpoint, sends a sample webhook, lists what arrived, then clears those requests and deletes the endpoint.
Using the API requires at least the Plus plan. Create a key under Dashboard → API Key before you import. The API guide explains the same calls.
Download
Section titled “Download”Install in Postman
Section titled “Install in Postman”- Open Postman and select your workspace.
- Click Use resources or import, then Import.
- Drop
webhookah.postman_collection.jsoninto the window, or paste this URL:
https://webhookah.com/docs/webhookah.postman_collection.json- Wait for Import complete. Webhookah appears in the sidebar.
You can also drag the file onto the Postman window.
Add your API key
Section titled “Add your API key”- Open the Webhookah collection.
- Open the Variables tab.
- Set
apiKeyto the key you copied from Dashboard → API Key. It starts withwh-. If Postman shows Initial value and Current value, put the key in Current value. - Leave
baseUrlashttps://webhookah.com. For a local server, set it tohttp://localhost:1323. - Save the collection.
endpointToken and endpointUrl stay empty until you run Create an endpoint. That request stores both for the later calls.
Requests in Receive a webhook, and Send a sample webhook, call the public /wh/{token} URL with no Authorization header.
Send a test webhook
Section titled “Send a test webhook”Run the Try a webhook folder from top to bottom:
- Create an endpoint —
POST /api/endpoints. Expect201. The test script savestokenandurl. - Send a sample webhook —
POSTto the saved URL with a JSON body. Expect200and{"message":"Webhook received successfully"}. - List requests for this endpoint —
GET /api/requests/endpoint/{{endpointToken}}. The sample send is in the array.body.jsonis the parsed object andbody.rawis the original text. - Clear requests for this endpoint —
DELETEthat same path. Expect204. Do this while the endpoint still exists. - Delete this endpoint —
DELETE /api/endpoints/{{endpointToken}}. Expect204. The URL stops accepting traffic.
A 403 with {"error":"URL limit reached for your plan"} means the account is at its endpoint limit.
In Postman, open the folder and use Run. Select only Try a webhook so the runner stays on this sequence.
Other requests in the collection
Section titled “Other requests in the collection”- Endpoints — list, create, set the badge, delete, and regenerate. Regenerate endpoints deletes every endpoint on the account and creates a new one.
- Captured requests — list or clear every captured request, or only one endpoint. Clear all requests deletes every captured request on the account. Endpoints stay.
- Live updates —
GET /api/ssereturnstext/event-stream. Send Listen for requests on its own. Stored requests arrive first, then new requests, plus a heartbeat about every 30 seconds. Cancel the request when you are done watching. - Receive a webhook —
POST,GET,PUT,PATCH, andDELETEto/wh/{{endpointToken}}. Header names that start withX-are dropped before storage.
Full request and response shapes are in the OpenAPI reference.