Skip to main content

​
Webhook Logs

Every webhook execution is logged, allowing you to monitor deliveries, troubleshoot failures, and correlate webhooks with the original API requests.

​
Viewing Webhook Logs

​
All Webhook Logs

  1. Navigate to Webhooks in the sidebar
  2. Click Webhook Logs tab
  3. View all webhook executions across all webhooks

​
Logs for a Specific Webhook

  1. Navigate to Webhooks in the sidebar
  2. Click on a specific webhook
  3. Select the Logs tab

​
Log Entry Details

Each log entry contains:
FieldDescription
Webhook NameThe webhook that was triggered
Event TypeThe event that triggered the webhook (e.g., request.success)
Executed AtTimestamp of the execution
SuccessWhether the delivery succeeded
Response StatusHTTP status code from your endpoint
Response TimeHow long the request took (ms)
Retry CountNumber of retry attempts
Request IDLinks to the original API request

​
Log Entry Detail View

Click on a log entry to see full details:

​
Request Sent

{
  "event": "request.success",
  "timestamp": "2025-01-15T10:30:45.123Z",
  "webhook_id": "wh_abc123",
  "webhook_name": "Slack Notifications",
  "data": {
    "route_id": "route_xyz789",
    "route_name": "payment-api",
    "request": {
      "method": "POST",
      "path": "/v1/charges"
    },
    "response": {
      "status": 200,
      "latency_ms": 342
    }
  }
}

​
Headers Sent

{
  "Content-Type": "application/json",
  "X-Webhook-Signature": "sha256=abc123...",
  "X-Webhook-ID": "wh_abc123",
  "X-Webhook-Event": "request.success",
  "Authorization": "Bearer ***CONFIGURED***"
}

​
Response Received

{
  "ok": true
}

​
Error Message (if failed)

Connection timeout after 30000ms

​
Filtering Logs

​
By Success/Failure

Success: ✓ Success Only
         ✗ Failures Only
         All

​
By Event Type

Event Type: request.success
            request.server_error
            request.completed
            (all)

​
By Webhook

Webhook: Slack Notifications
         Analytics Logger
         (all)

​
By Request ID

Correlate with API logs: 
Request ID: req_abc123def456

​
Common Failure Scenarios

​
Connection Timeout

Log shows: 
Error: Request timeout
Response Time: 30000ms
Success: false
Causes:
  • Your endpoint is too slow
  • Network connectivity issues
  • Firewall blocking requests
Solutions:
  • Increase webhook timeout setting
  • Optimize your endpoint response time
  • Check firewall rules

​
HTTP 4xx Response

Log shows: 
Response Status: 401 Unauthorized
Success: false
Causes:
  • Incorrect authentication configuration
  • Token expired
  • Endpoint URL changed
Solutions:
  • Verify auth credentials
  • Regenerate tokens if expired
  • Check endpoint URL

​
HTTP 5xx Response

Log shows: 
Response Status: 500 Internal Server Error
Success: false
Retry Count: 3
Causes:
  • Your endpoint has a bug
  • Your endpoint’s dependencies are down
  • Rate limiting on your endpoint
Solutions:
  • Check your endpoint logs
  • Verify endpoint dependencies
  • Implement proper error handling

​
Connection Refused

Log shows: 
Error: connect ECONNREFUSED 127.0.0.1:3000
Success: false
Causes:
  • Endpoint server not running
  • Incorrect port
  • Firewall blocking
Solutions:
  • Verify endpoint is running
  • Check port number
  • Review firewall rules

​
Correlating with API Logs

Each webhook log includes a request_id that links to the original API request:
  1. Find the webhook log entry
  2. Copy the Request ID
  3. Navigate to API Logs
  4. Search by Request ID
This lets you see:
  • The original request that triggered the webhook
  • Full request/response details
  • Client information
  • Timing breakdown

​
Webhook Statistics

On the webhook detail page, view aggregate statistics:
MetricDescription
Trigger CountTotal times triggered
Success CountSuccessful deliveries
Failure CountFailed deliveries
Last TriggeredMost recent trigger time
Last SuccessMost recent successful delivery
Last FailureMost recent failed delivery

​
Log Retention

Webhook logs are retained based on your plan:
PlanRetention
Starter7 days
Pro30 days
Enterprise90 days

​
Next Steps

Testing Webhooks

Test your webhook configuration

API Logs

Correlate with API requests

Webhooks Overview

Learn about webhooks

Creating Webhooks

Create your first webhook

Statistics

  • Level: beginner
  • Time: 5 minutes

Tags

webhooks, logs, monitoring, debugging, troubleshooting