Skip to main content

​
Overview

Webhooks allow you to receive notifications when your Coval evaluations complete. When a run finishes, Coval will send a POST request to your configured webhook endpoints.

​
Configure Webhook Endpoints

Navigate to https://app.coval.dev/settings The webhook configuration interface includes:
  1. Webhook Type Dropdown: Select “Job Complete” from the available options
  2. Webhook URL Input: Enter the URL where you want to receive notifications
  3. Add Webhook Button: Click to save your webhook configuration
  4. Webhook List: View and manage your existing webhooks
  5. Delete Button: Remove webhooks using the trash icon

​
Supported Webhook Types

  • Job Complete: Triggers when evaluation runs complete

​
Webhook Data Format

When a run completes, your webhook endpoint will receive a POST request with: 
{
  "organization_id": "string",
  "message": "▲  Run on [Test Set Name] Succeeded: https://app.coval.dev/your-org/runs/[run-id]\n       Created By: [user]\n\n[metric results if available]",
  "run_id": "string",
  "status": "COMPLETED|FAILED"
}
The payload includes:
  • organization_id: Your organization’s ID
  • message: The formatted alert message with run details and metrics
  • run_id: The ID of the completed run
  • status: The status of the run (COMPLETED or FAILED)