Quickstart: Get Started with FetchHook in 5 Minutes

Go from zero to receiving webhooks in under 5 minutes. No credit card, no tunnel, no configuration.

#Step 1: Provision Your API Key

Sign up at fetchhook.app and click 'Provision API Key' in your dashboard. You'll get three things: an API key (keep this secret), a webhook URL (give this to webhook providers), and a fetch URL (use this to retrieve webhooks).

Your Credentials

bash

# Save these securely:
API_KEY=fh_your_api_key_here
WEBHOOK_URL=https://api.fetchhook.app/in/src_your_source_id
FETCH_URL=https://api.fetchhook.app/api/v1/src_your_source_id

#Step 2: Send a Test Webhook

Send a webhook to your mailbox URL. This simulates what Stripe, GitHub, or any webhook provider would do.

Send Test Webhook

bash

curl -X POST https://api.fetchhook.app/in/src_your_source_id \
  -H "Content-Type: application/json" \
  -d '{"event": "test.webhook", "message": "Hello FetchHook!"}'
  
# Response:
# {"status":"received","event_id":"evt_abc123"}

#Step 3: Fetch Your Webhook

Retrieve the webhook from your mailbox using your API key. This is how your application pulls events whenever it's ready.

Fetch Webhooks

bash

curl https://api.fetchhook.app/api/v1/src_your_source_id \
  -H "Authorization: Bearer fh_your_api_key"
  
# Response:
# {
#   "events": [
#     {
#       "event_id": "evt_abc123",
#       "provider": "unknown",
#       "payload": {"event": "test.webhook", "message": "Hello FetchHook!"},
#       "received_at": "2026-02-04T12:00:00Z"
#     }
#   ],
#   "count": 1
# }

#Next Steps

You're now receiving webhooks! Here's what to explore next:

Connect real webhook providers (Stripe, GitHub, Shopify)
Add signature verification for security
Build a polling loop to fetch webhooks continuously
Check out language-specific examples (Python, Node.js, Go)

Agent Protocol Instruction

For production use: Always verify webhook signatures, implement exponential backoff when polling, and handle webhook TTL (24 hours). See the Authentication and Webhooks Guide docs for details.