Skip to content
English
Claudio
  • There are no suggestions because the search field is empty.

How do I Configure a Webhook for Job Logs?

Comprehensive guide for setting up and managing webhooks in Loom Analytics

Description: Webhooks allow you to receive job status updates in Webhook Logs by sending POST requests to your server endpoint. Once configured, your webhook endpoint will receive HTTP POST requests whenever a job you submit changes status. All webhook activity is logged in the Webhook Logs section for monitoring and troubleshooting.

 

How It Works:

When you configure a webhook in the Loom Analytics platform, you provide your server's webhook URL and receive a unique webhook secret. After configuration, any job submitted through your account will trigger webhook POST requests to your endpoint with job status updates. All webhook attempts and their responses are recorded in Webhook Logs for your review.

 

Configuring Your Webhook (Requires Team Admin Access)

Step 1: Navigate to Webhook Settings

  1. Log in to your Loom Analytics account.
  2. Click on gear icon on top-right side.
  3. Go to Integrations in the left navigation menu
  4. Select Webhooks.

 

Step 2: Enter Webhook URL

In the Webhook URL field, enter your server's endpoint that will receive logs for your jobs.

 

 

Important: Ensure your webhook endpoint:

  • Is publicly accessible via HTTPS
  • Can accept POST requests
  • Returns HTTP 200 status for successful receipt
  • Implements proper authentication using the webhook secret

 

Step 3: Webhook Secret

A Webhook Secret will be automatically generated when you configure your webhook. This secret is used to verify that notifications are genuinely from Loom Analytics.

The secret appears as a masked string in the interface. You can:

  • Copy the secret using the copy icon
  • View the secret using the eye icon
  • Regenerate a new secret if needed (note: this will invalidate the previous secret)

 

Step 4: Test Your Webhook

Before saving, it's crucial to test your webhook configuration:

  1. Click the Test Webhook button
  2. The system will send a test notification to your endpoint

Expected Test Responses:

Successful Test: A green notification will appear at the top-left of the screen:

 
 

 

Failed Test: An error message will be displayed indicating the issue:

 
 

 

Common Error Codes:

  • HTTP 405: Method Not Allowed - Your endpoint doesn't accept POST requests
  • HTTP 404: Not Found - The webhook URL is incorrect or endpoint doesn't exist
  • HTTP 401/403: Unauthorized/Forbidden - Authentication issues
  • HTTP 500: Internal Server Error - Issue with your webhook handler
  • Timeout: Your endpoint is unreachable or taking too long to respond

 

Step 5: Save Configuration

Once the test is successful, click Save Webhook to enable the logs for your jobs in Webhook Logs section.

Monitoring Webhook Activity

After configuring your webhook, all webhook events are logged and can be viewed in the Webhook Logs section under Integrations.

 

Managing Your Webhook

Delete Webhook: To remove webhook configuration, click the Delete Webhook button. This will:

  • Deactivate webhook notifications
  • Remove the webhook URL from your account
  • Invalidate the current webhook secret

After deletion, you will need to reconfigure the webhook to receive notifications again.

 

Learn more about Webhook Logs here.