Documentation

Everything you need to know about using TraceBin to capture, inspect, and replay webhooks.

Getting Started

TraceBin makes webhook debugging simple. Follow these steps to get started:

1

Create a Bin

Sign up and create your first webhook bin to get a unique capture URL.

2

Send Webhooks

Point your webhook source to your TraceBin URL and start capturing requests.

3

Inspect & Replay

View captured requests in detail and replay them to test your integrations.

Quick Start Example

# 1. Create a bin and get your capture URL
# Your URL will look like: https://tracebin.com/b/abc123/webhook
# 2. Send a test webhook
curl -X POST https://tracebin.com/b/abc123/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "user.created", "user_id": 123}'
# 3. View the captured request in your TraceBin dashboard

Webhook Capture

TraceBin captures all incoming webhook requests automatically. Here's how it works:

Capture URL Format

https://tracebin.com/b/{token}/{path}
1
Token: Your unique bin identifier (auto-generated)
2
Path: Any path you want (e.g., "webhook", "api/events", "stripe")

Supported HTTP Methods

POST Most common for webhooks

Perfect for webhook payloads with JSON or form data

GET For simple requests

Useful for testing and simple integrations

What Gets Captured

  • HTTP method and path
  • All request headers
  • Request body (up to 2MB)
  • Query parameters
  • Source IP address
  • Timestamp and metadata

Request Inspection

Once webhooks are captured, you can inspect every detail in your TraceBin dashboard.

Pretty Printing

JSON and XML bodies are automatically formatted for easy reading.

{
  "event": "user.created",
  "data": {
    "id": 123,
    "email": "user@example.com"
  }
}

Header Analysis

View all request headers with syntax highlighting and categorization.

Content-Type: application/json
Authorization: Bearer sk_...
User-Agent: Stripe/v1
X-Request-ID: req_123...

Export Options

cURL Command

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"event":"user.created"}' \
  https://your-endpoint.com/webhook

HTTPie Command

http POST \
  your-endpoint.com/webhook \
  Content-Type:application/json \
  event=user.created

Replay Functionality

Pro Feature

Replay functionality is available only on Pro plans. Upgrade to unlock this powerful feature.

Replay captured webhooks to test your integrations, debug issues, and verify webhook delivery.

1. Select Request

Choose any captured webhook from your bin

2. Set Target

Enter the URL where you want to replay the webhook

3. Execute & Monitor

Watch the replay execute and capture the response

Replay Features

  • Exact request reproduction (method, headers, body)
  • Response capture and analysis
  • Performance timing and metrics
  • Error handling and timeout management
  • Unlimited replays per request
  • Real-time status updates

API Reference

Webhook Capture Endpoint

POST /b/{token}/{path}

Parameters

Parameter Type Description
token string Your unique bin identifier
path string Any path segment (optional)

Response

HTTP/1.1 204 No Content
X-TraceBin-Request-Id: req_abc123
X-TraceBin-Rate-Limited: false

Rate Limiting

Free Plan: 20 requests per day

Pro Plan: 1,000 requests per day

Error Responses

404 Not Found
Invalid bin token
429 Too Many Requests
Rate limit exceeded
413 Payload Too Large
Request body exceeds 2MB limit

Examples

Common Use Cases

Stripe Webhook Testing

curl -X POST https://tracebin.com/b/abc123/stripe \
  -H "Content-Type: application/json" \
  -H "Stripe-Signature: t=1234567890,v1=..." \
  -d '{
    "id": "evt_1234567890",
    "object": "event",
    "type": "payment_intent.succeeded"
  }'

Perfect for testing Stripe webhook integrations and verifying event data.

GitHub Webhook Debugging

curl -X POST https://tracebin.com/b/abc123/github \
  -H "Content-Type: application/json" \
  -H "X-GitHub-Event: push" \
  -H "X-GitHub-Delivery: 12345678-1234-1234-1234-123456789abc" \
  -d '{
    "ref": "refs/heads/main",
    "repository": {
      "name": "my-app"
    }
  }'

Debug GitHub webhooks and verify repository events are being sent correctly.

Custom API Testing

curl -X POST https://tracebin.com/b/abc123/api/orders \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-token" \
  -d '{
    "order_id": "ORD-12345",
    "status": "completed",
    "amount": 99.99
  }'

Test your own API endpoints and verify webhook payloads are formatted correctly.

Ready to start debugging webhooks?

Create your first bin and start capturing webhooks in minutes.

Get Started Free View Examples