Skip to main content

Webhook Logs Dashboard

The Webhook Logs Dashboard provides comprehensive monitoring and troubleshooting capabilities for webhook deliveries in your marketplace application. This guide covers how to access, navigate, and effectively use the dashboard to monitor your webhook integrations.

Table of Contents​

  1. Overview
  2. Accessing Webhook Logs
  3. Understanding the Dashboard
  4. Using Date & Time Filters
  5. Searching Logs
  6. Filtering by Event Name
  7. Filtering by Status Code
  8. Navigating Through Pages
  9. Viewing Webhook Details
  10. Clearing All Filters
  11. Common Use Cases
  12. FAQ

Overview​

The Webhook Logs Dashboard enables you to:

  • View all webhook events sent to your application
  • Track success and failure rates
  • Search for specific webhook IDs
  • Filter by event type and status codes
  • View detailed payload information
  • Monitor retry attempts
  • Work with different timezones

Accessing Webhook Logs​

  1. Navigate to your Application Dashboard
  2. Click on Select The App You Want Logs For
  3. Select Insights from the left menu
  4. Click on Logs
  5. The Webhooks tab will be active by default

Webhook Logs Dashboard

URL Pattern​

/app-settings/{your-app-id}/dashboard/logs

Understanding the Dashboard​

Statistics Cards​

The dashboard displays three key metrics at the top of the page:

Total Events​

  • Shows the number of unique events received during the selected period
  • Includes both successful and failed webhooks
  • Updates based on your selected date range and filters
  • Deduplicates by webhook ID

Consumer Errors​

  • Displays webhooks that failed (non-2xx status codes)
  • High numbers indicate potential issues with your webhook endpoint

Total Attempts​

  • Shows all delivery attempts including retries
  • If this number is higher than Total Events, your app is experiencing retries
  • Helps identify webhook delivery issues

NOTE: Webhooks are retried with a 10-minute interval (with jitter) for up to 6 attempts when your endpoint returns a 429 status code. For detailed retry policy information, see the Error Handling and Retries section.

Logs Table​

The logs table displays the following columns:

ColumnDescriptionExample
Event NameType of webhook eventContactCreate, INSTALL
Webhook IDUnique identifier for trackingabc123def456...
Attempted AtWhen the webhook was sent2024-11-13 14:30:45
Status CodeHTTP response status200 (success) or 404 (error)
Attempt #Delivery attempt number1st, 2nd, 3rd

Status codes are color-coded: green for success (2xx) and red for errors (all others).

Using Date & Time Filters​

Date & Time Pickers​

  • By default, the logs display the last 1 hour of webhook activity
  • You can change the date range with up to 1 second accuracy for any period within the past 30 days
  • The date pickers provide quick shortcuts:
    • Today: Jump to today's date
    • Last 7 Days: View the past week
    • Last 30 Days: View the past month (maximum range)

NOTE: Logs are retained for the last 30 days

Date Picker

Changing Timezone​

All webhook times are stored in UTC, but you can view them in your local timezone for easier reading.

How to Change Timezone​

  1. Locate the timezone dropdown on the right
  2. Click and start typing your timezone (e.g., "America/New_York")
  3. Select your timezone from the list
  4. All times will instantly convert to your selected timezone

Timezone Features​

  • Your selection is saved automatically
  • All times in the table update immediately
  • Modal details also display in your selected timezone
  • Search for timezones by typing

Example:

  • UTC: 2024-11-13 14:30:00
  • Eastern Time: 2024-11-13 09:30:00

Searching Logs​

The search bar is located in the top-left of the table and allows you to search for specific webhooks.

  • Webhook ID: Enter the full or partial webhook ID
  • Webhook Payloads: Enter the value or full key-value pair to search in the payload

  1. Click in the search box

  2. To search by webhook ID: Type your webhook ID (e.g., abc123....)

  3. To search by payload: Enter the value or full key-value pair from the payload

    Example payload:

    {
      "type": "OpportunityCreate",
      "locationId": "3jJ0coeqWCZMAosyGQ6K",
      "versionId": "6878cec452e7c8d29d4dd3d9",
      "appId": "6878cec452e7c8d29d4dd3d9",
      "id": "UHXrFfZGSH5rj7z5rdDP",
      "name": "Test 2",
      "assignedTo": null,
      "contactId": "VQxH1EeoFPg9uhhnCeJx",
      "pipelineId": "WQ7tyljQSXAg7GuTgYdd",
      "pipelineStageId": "403af14e-9afb-40b1-b394-0aa6bbe0cc5e",
      "status": "open",
      "dateAdded": "2025-11-07T12:40:44.510Z",
      "timestamp": "2025-11-07T12:46:45.953Z",
      "webhookId": "881b9415-5d35-4ff1-a667-0545b80b96c0"
    }
    • Any substring of value will work. ex - FPg9uhhnCe (substring from contactId)
    • Any one key-value pair will work. ex - "contactId": "VQxH1EeoFPg9uhhnCeJx" or name: Test 2 (quotes not important)
    • random substring of json will not work. ex - sionId": "6878cec452e7c8d29d4dd3d9", "appId": "6878cec452e7c
    • multiple key values will not work. ex - "appId": "6878cec452e7c8d29d4dd3d9", "id": "UHXrFfZGSH5rj7z5rdDP"

  4. Results will update automatically

Search Bar

Search Features​

  • Search is case-insensitive
  • Partial matches work (search "abc" finds "abc123def")
  • Click the X button to clear search
  • Search works with other filters simultaneously

Filtering by Event Name​

Opening the Filter​

  1. Find the Event Name column header
  2. Click the filter icon (funnel symbol)
  3. A dropdown menu will appear

Event Name Filter

Sorting Options​

  • Sort A-Z (Ascending): Click to sort events alphabetically
  • Sort Z-A (Descending): Click to sort events in reverse order
  • A blue checkmark indicates the active sort

NOTE: Click on it again to remove the sort

Filter by Condition​

Filter event names by text patterns.

Available Conditions​

  1. None: No text filtering (default)
  2. Text contains: Show events containing your text
  3. Text does not contain: Exclude events with your text
  4. Text starts with: Show events beginning with your text
  5. Text ends with: Show events ending with your text
  6. Text is exactly: Show only exact matches

How to Use​

  1. Click "Filter by Condition" to expand
  2. Select a condition from the dropdown
  3. Type your search text in the input box
  4. Click "Apply" at the bottom

Example:

  • Condition: "Text starts with"
  • Input: "Contact"
  • Result: Shows ContactCreate, ContactUpdate, ContactDelete, ContactDndUpdate & ContactTagUpdate

Filter by Values (Checkboxes)​

Select specific event names to view.

How to Use​

  1. Click "Filter by Values" to expand
  2. You'll see checkboxes for all available events
  3. Use the search box to filter the checkbox list
  4. Select All: Check all visible events
  5. Clear: Uncheck all events
  6. Select one or more event names
  7. Click "Apply" at the bottom

Clearing Event Name Filters​

  • Click "Clear" button at the bottom of the filter dropdown
  • Or use the main "Clear Filters" button at the top

Filtering by Status Code​

Opening the Filter​

  1. Find the Status Code column header
  2. Click the filter icon (funnel symbol)
  3. A dropdown menu will appear

Quick Filter Options​

  • Filter By Success: Click to show only successful webhooks (status codes 200-299)
  • Filter By Failure: Click to show only failed webhooks (includes all non-2xx status codes: 3xx redirects, 4xx client errors, and 5xx server errors)
  • A blue checkmark indicates when a filter is active

Note: You can only use one quick filter at a time (Success OR Failure)

Filter by Specific Status Codes​

Select exact status codes to view. You can select multiple status codes simultaneously (e.g., 200 and 404) to create custom filter combinations.

How to Use​

  1. Click "Filter by Values" to expand
  2. See checkboxes for common HTTP status codes:
    • Success: 200, 201, 204
    • Client Errors: 400, 401, 403, 404, 422, 429
    • Server Errors: 500, 502, 503, 504
  3. Use the search box to find specific codes
  4. Select All: Check all status codes
  5. Clear: Uncheck all
  6. Select the codes you want to see
  7. Click "Apply"

Status Code Colors​

  • Green tag = Success (200-299)
  • Red tag = Error (all others)

Pagination Controls​

Pagination controls are located at the bottom-right of the table.

Changing Rows Per Page​

  1. Locate the "Rows per page" dropdown
  2. Choose from:
    • 10 rows (default)
    • 20 rows
    • 50 rows
  3. Table updates immediately

Moving Between Pages​

Using Page Numbers​

  • Click any page number to jump to that page
  • Current page is highlighted in blue
  • Shows up to 7 page numbers at a time

Using Previous/Next Buttons​

  • Previous: Go back one page (disabled on first page)
  • Next: Go forward one page (disabled on last page)

Note: Your filters remain active when you change pages.

Viewing Webhook Details​

Opening the Details Modal​

  1. Click on any row in the logs table
  2. A modal window will appear with full details
Webhook Details Modal

What You'll See​

Webhook URL​

  • The endpoint where the webhook was sent
  • Copy button: Click to copy the URL to your clipboard
  • Useful for verifying the correct endpoint

Event Information​

  • Event Name: Type of webhook (e.g., ContactCreate)
  • Webhook ID: Unique identifier for this webhook
  • Attempt #: Which delivery attempt (1st, 2nd, 3rd, etc.)
  • Attempted At: When it was sent (in your selected timezone)
  • Triggering Event: What caused this webhook

Payload​

  • JSON data sent with the webhook
  • Automatically formatted for easy reading
  • Copy button: Click to copy entire payload
  • Useful for:
    • Debugging issues
    • Understanding data structure
    • Testing with sample data

Using the Payload​

Copy the Payload​

  1. Click the "Copy" button above the payload
  2. Paste into your code editor or testing tool
  3. Use it to reproduce issues locally

Clearing All Filters​

When to Clear Filters​

  • You've applied multiple filters and want to start fresh
  • You're not seeing expected results
  • You want to view all webhooks in the date range

How to Clear​

  1. Locate the "Clear Filters" button (top-left, blue text with refresh icon)
  2. Click the button
  3. All filters are removed instantly

What Gets Cleared​

  • Search text
  • Event name filters (sort, conditions, selected values)
  • Status code filters (sort, selected values)
  • Pagination resets to page 1

What Stays​

  • Date & time range (not cleared)
  • Timezone selection (not cleared)

Note: The button is only enabled when you have active filters.

Common Use Cases​

Use Case 1: Finding a Specific Webhook​

Scenario: Support provided a webhook ID to investigate

Steps:

  1. Copy the webhook ID
  2. Paste it in the search bar
  3. Press Enter or wait for auto-search
  4. Click the row to see full details

Use Case 2: Troubleshooting Failed Webhooks​

Scenario: Your app isn't receiving webhooks properly

Steps:

  1. Open Status Code filter
  2. Click "Filter By Failure"
  3. Click "Apply"
  4. Review the failed webhooks
  5. Click rows to see error codes and payloads
  6. Look for patterns:
    • All 404? Your endpoint URL might be wrong
    • All 401? Check authentication
    • All 500? Your server has errors

Use Case 3: Checking Retry Behavior​

Scenario: You want to see if webhooks are being retried

Steps:

  1. Look at the "Attempt #" column
  2. Search for a specific Webhook ID that appears multiple times
  3. Look for entries like "2nd", "3rd", "4th"
  4. High attempt numbers indicate persistent failures
  5. Click to view details and see what changed between attempts

Use Case 4: Monitoring Event Volume​

Scenario: You want to know how many webhooks you're receiving

Steps:

  1. Set date range to "Last 7 Days" or "Last 30 Days"
  2. Look at "Total Events" statistic
  3. Compare to "Total Attempts"
  4. High difference indicates many retries happening
  5. Check "Consumer Errors" to see failure rate

Use Case 5: Focusing on Specific Events​

Scenario: You only care about contact-related webhooks

Steps:

  1. Open Event Name filter
  2. Click "Filter by Values"
  3. Type "CONTACT" in the search box
  4. Select all contact events:
    • ContactCreate
    • ContactUpdate
    • ContactDelete
  5. Click "Apply"
  6. Now you only see contact webhooks

Use Case 6: Investigating Issues at Specific Time​

Scenario: Your app had issues yesterday at 2 PM

Steps:

  1. Select your timezone first
  2. Set start date/time to yesterday 2:00 PM
  3. Set end date/time to yesterday 3:00 PM
  4. Open Status Code filter
  5. Click "Filter By Failure"
  6. Review what went wrong during that hour

Use Case 7: Comparing Success vs Failure​

Scenario: You want to see the success rate

Steps:

  1. Note "Total Events" number
  2. Note "Consumer Errors" number
  3. Calculate: (Total Events - Consumer Errors) / Total Events × 100
  4. Example: (1000 - 50) / 1000 = 95% success rate
  5. Filter by failures to investigate the remaining percentage

Use Case 8: Post-Deployment Verification​

Scenario: You just deployed a webhook fix

Steps:

  1. Note the deployment time in your timezone
  2. Set start time to deployment time
  3. Set end time to now
  4. Filter by the event name you fixed
  5. Check "Consumer Errors" should be low/zero
  6. Click rows to verify correct payloads

FAQ​

Why is no data showing in the logs?

Check Your Date Range:

  • Make sure start date is before end date
  • Invalid ranges show an error message
  • Try using the "Last 7 Days" shortcut

Check Your Filters:

  • Click "Clear Filters" button
  • Remove any event name or status code filters
  • Clear the search box

Verify Webhooks Are Configured:

  • Go to your app's Webhooks settings
  • Ensure webhook URLs are configured
  • Check that events are subscribed

For detailed guide on setting up webhooks, please refer to the Webhook Integration Guide.

Why don't the times look right?

Timezone Issue:

  • Check the timezone selector
  • Select your correct timezone
  • Times should update immediately

Still Wrong?

  • Try refreshing the page
  • Clear browser cache
  • Check if your system timezone is correct
I can't find a specific webhook. What should I do?

Try Broader Search:

  • Use partial Webhook ID (first few characters)
  • Expand your date range
  • Remove other filters first

Check Spelling:

  • Webhook IDs are case-sensitive in some systems
  • Try copying and pasting exactly
Why isn't my filter working?

Did You Click Apply?

  • Filters require clicking "Apply" button
  • Just selecting options doesn't activate them

Conflicting Filters:

  • Text conditions clear selected values
  • Selected values clear text conditions
  • Success/Failure sorts clear specific status code selections

Try Clear and Reapply:

  • Click "Clear" in the filter dropdown
  • Reapply your filter
  • Click "Apply"
I can't open the details modal. How do I fix this?

Row Not Clickable?

  • Make sure you're clicking the row, not just hovering
  • Check browser console for errors (F12)
  • Try a different row

Modal Shows Error:

  • The webhook detail might be unavailable
  • Try refreshing the page
  • Contact support if it persists
Why isn't the copy button working?

Browser Permissions:

  • Modern browsers require HTTPS for clipboard
  • Check if site is secure (padlock icon)
  • Try allowing clipboard permissions in browser settings

Manual Copy:

  • Select the text manually
  • Right-click → Copy
  • Or use Ctrl+C (Windows) / Cmd+C (Mac)
Why don't the statistics match my expectations?

Statistics Respect Filters:

  • If you've filtered by event name, stats only show those events
  • If you've filtered by failures, stats only show failed webhooks
  • Click "Clear Filters" to see overall stats

Date Range Matters:

  • Statistics only count webhooks in your selected date range
  • Expand the date range to see more data

Need More Help?​

This guide is designed to help you effectively monitor and troubleshoot webhook deliveries. For integration setup and detailed webhook event documentation, please refer to the Webhook Integration Guide and the Complete Webhook Documentation.