Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.parallel.ai/llms.txt

Use this file to discover all available pages before exploring further.

For AI agents: a documentation index is available at https://docs.parallel.ai/llms.txt. The full text of all docs is at https://docs.parallel.ai/llms-full.txt. You may also fetch any page as Markdown by appending .md to its URL or sending Accept: text/markdown.
Prerequisites: Before implementing Monitor webhooks, read Webhook Setup & Verification for critical information on:
  • Recording your webhook secret
  • Verifying HMAC signatures
  • Security best practices
  • Retry policies
This guide focuses on Monitor-specific webhook events and payloads.

​
Overview

Webhooks allow you to receive real-time notifications when a Monitor execution completes, fails, or when material events are detected, eliminating the need for polling. This is especially useful for scheduled monitors that run at long gaps (hourly, daily, or weekly) and notify your systems only when relevant changes occur.

​
Setup

To register a webhook for a Monitor, include a webhook parameter when creating the monitor: 
curl --request POST \
  --url https://api.parallel.ai/v1/monitors \
  --header "Content-Type: application/json" \
  --header "x-api-key: $PARALLEL_API_KEY" \
  --data '{
    "type": "event_stream",
    "frequency": "1d",
    "processor": "lite",
    "settings": {
      "query": "AI startup funding announcements"
    },
    "webhook": {
      "url": "https://your-domain.com/webhooks/monitor",
      "event_types": [
        "monitor.event.detected",
        "monitor.execution.completed",
        "monitor.execution.failed"
      ]
    },
    "metadata": { "team": "research" }
  }'

​
Webhook Parameters

ParameterTypeRequiredDescription
urlstringYesYour webhook endpoint URL. Can be any domain you control.
event_typesarray[string]YesEvent types to subscribe to. See Event Types below.

​
Event Types

Monitors support the following webhook event types:
Event TypeDescription
monitor.event.detectedEmitted when a run detects one or more material events.
monitor.execution.completedEmitted when a Monitor run completes successfully (without detected events).
monitor.execution.failedEmitted when a Monitor run fails due to an error.
You can subscribe to any combination of these event types in your webhook configuration. Note that monitor.event.detected and monitor.execution.completed are mutually distinct and correspond to different runs.

​
Webhook Payload Structure

For Monitor webhooks, the data object contains:
  • monitor_id: The unique ID of the Monitor
  • event: The event record for this run.
  • metadata: User-provided metadata from the Monitor (if any)
{
  "type": "monitor.event.detected",
  "timestamp": "2025-10-27T14:56:05.619331Z",
  "data": {
    "monitor_id": "monitor_0c9d7f7d5a7841a0b6c269b2b9b1e6aa",
    "event": {
      "event_group_id": "mevtgrp_b0079f70195e4258eab1e7284340f1a9ec3a8033ed236a24"
    },
    "metadata": { "team": "research" }
  }
}

​
Security & Verification

For HMAC signature verification and language-specific examples, see the Webhook Setup Guide - Security & Verification.

​
Retry Policy

See Webhook Setup Guide - Retry Policy for delivery retries and backoff details.