Webhooks allow PageCrawl to send HTTP POST requests to any external URL whenever a page change is detected or an error occurs. Use webhooks to connect PageCrawl with custom applications, automation platforms, databases, or any service that accepts HTTP requests.

Setting Up a Webhook

1. Go to Settings > Workspace > Integrations
2. Select the Webhooks tab
3. Click Add Webhook
4. Enter your target URL and configure the options below
5. Click Save

Configuration Options

Target URL: The HTTP endpoint that will receive the POST request.

Event Triggers: Choose which events fire the webhook:

• Change detected - Fires when page content changes
• Error - Fires when a check fails (timeout, blocked, 404, etc.)
• Or both

Page Filter: Optionally limit the webhook to a specific monitored page. If not set, the webhook fires for all pages in the workspace.

Active/Inactive Toggle: Disable a webhook without deleting it.

Payload Fields

By default, webhooks send all available fields. You can customize the payload by selecting only the fields you need:

Category	Fields
Basic	id, title, status, changed_at, visual_diff, difference, human_difference, short_summary
Differences	markdown_difference, html_difference
Images	text_difference_image, page_screenshot_image
Page Info	page metadata, page_elements array
Content	contents, original (for extracted values)
Comparison	previous_check data
JSON	json, json_patch
AI	ai_summary, ai_priority_score

Testing Webhooks

After saving a webhook, click the Test button to send a sample payload to your endpoint. This verifies the connection works before relying on it for real notifications.

Example Payload

{
  "id": 12345,
  "title": "Product Page - Example.com",
  "status": "change_detected",
  "changed_at": "2026-01-15T10:30:00Z",
  "visual_diff": 12.5,
  "difference": 3,
  "human_difference": "3 lines changed",
  "short_summary": "Price updated from $99 to $89",
  "ai_summary": "The product price was reduced by 10%.",
  "ai_priority_score": 85
}

Use Cases

• Custom dashboards - Feed change data into your own monitoring dashboard
• Database logging - Store all detected changes in your own database
• Automation workflows - Trigger actions in tools like n8n, Make, or custom scripts
• Alerting systems - Forward high-priority changes to PagerDuty, Opsgenie, or similar tools

Notes

• Webhooks send data as HTTP POST with a JSON body
• If you need Slack, Discord, or Teams notifications, use the dedicated integrations instead, as they format messages correctly for those platforms
• Webhooks are available on paid plans