Getting Started
Set up Hookshot and send your first webhook in minutes.
1
API Key Setup
Get your API key from the dashboard to authenticate requests.
Enter your API key to test the endpoints below. Get one from the dashboard.
2
Create an Endpoint
Register the URL where you want to receive webhooks.
POST
/endpointscurl -X POST https://api.hookshot.tech/endpoints \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"label": "Production", "url": "https://your-server.com/webhook"}'Try it live
Tip: Use httpbin.org/post to test without a real server
3
Send a Webhook Event
Ingest events that will be delivered to all registered endpoints with automatic retries.
POST
/ingestcurl -X POST https://api.hookshot.tech/ingest \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"eventType": "order.created",
"payload": {
"orderId": "12345",
"amount": 99.99
}
}'Try it live
Targeted Delivery
By default, events broadcast to all endpoints. To target specific endpoints:
Single endpoint
"endpointId": "endpoint-uuid"Multiple endpoints
"endpointIds": ["uuid-1", "uuid-2"]4
List Events
View delivery status and paginate through your webhook events.
GET
/eventscurl https://api.hookshot.tech/events?limit=10&status=pending \
-H "x-api-key: YOUR_API_KEY"