Quickstart

This guide will get you up and running with webhook.rodeo in just a few minutes. You'll create your first webhook, send a test event, and see how easy it is to capture and inspect webhook data.

Get your webhook URL

Sign up for webhook.rodeo to get your first live webhook URL instantly. We'll automatically create a webhook for you to start testing with.

After signing up, you'll have:

• A live webhook URL ready to receive events
• A dashboard to view and inspect all incoming webhooks
• The ability to forward webhooks to your application
• Automatic retries and delivery tracking

Send a test event

Let's send a test webhook to see it in action. Open your terminal and run:

curl -X POST https://webhook.rodeo/w/your-username/github-webhooks \
  -H "Content-Type: application/json" \
  -d '{
    "event": "test",
    "message": "Hello from the quickstart guide!",
    "timestamp": "2024-01-15T10:30:00Z"
  }'

You should see a response like:

{
  "success": true,
  "requestId": "req_abc123def456"
}

The requestId is a unique identifier for this specific webhook event. You can use it to track the event through the system.

View your event

Head back to your webhook.rodeo dashboard and click on your webhook. You'll see your test event listed with:

• Timestamp - When it arrived
• Status - Success (green checkmark)
• Request ID - The unique identifier
• Payload preview - First few lines of your JSON

Click on the event to see the full details:

• Complete request headers
• Full JSON payload with syntax highlighting
• Client IP address
• Content type

Pretty cool, right? You now have a complete audit trail of what was sent.

Add a forward URL

webhook.rodeo can do more than just capture webhooks—it can forward them to your application. Here's how:

1. Click "Edit" on your webhook
2. Switch to the "URL" destination type
3. Enter your forward URL (e.g., https://your-app.com/webhooks/github)
4. Click "Save"

Now every webhook received will be:

1. Logged in your dashboard (for debugging)
2. Forwarded to your URL (for processing)
3. Retried automatically if delivery fails

You can test this by sending another curl request—this time webhook.rodeo will forward it to your URL and show you the response in the event details.

What's next?

Now that you've created your first webhook, here are some next steps: