Getting Started

Getting Started

1. Create Account

Sign up at hooksniff.vercel.app/register — no credit card required.

2. Get API Key

Your API key is auto-generated on signup. Find it in Dashboard → Settings → API Configuration.

3. Create an Endpoint

curl -X POST https://hooksniff-api-e6ztf3x2ma-ew.a.run.app/v1/endpoints \
  -H "Authorization: Bearer hr_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-app.com/webhooks", "description": "My production endpoint"}'

4. Send a Webhook

curl -X POST https://hooksniff-api-e6ztf3x2ma-ew.a.run.app/v1/webhooks \
  -H "Authorization: Bearer hr_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoint_id": "ep_YOUR_ENDPOINT_ID", "event": "order.created", "data": {"order_id": "ord_123", "total": 49.99}}'

5. Verify Signature

Every webhook includes an HMAC-SHA256 signature. Verify it on your server:

const crypto = require('crypto');
const signature = req.headers['x-hooksniff-signature'];
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
const valid = crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));

6. Monitor Deliveries

Go to Dashboard → Deliveries to see all webhook deliveries with status, timing, and error details.

SDK Quick Start

# Node.js
npm install hooksniff-sdk

# Python
pip install hooksniff

# Go
go get github.com/servetarslan02/hooksniff-go

# Rust
cargo add hooksniff

Free Tier

• 300 events/day (9,000/month)
• Unlimited endpoints
• HMAC-SHA256 signatures
• 7-day log retention
• No credit card required