Skip to main content
Webhooks let you receive real-time HTTP callbacks when events happen in PG:AI - account updates, new intelligence, score changes, and more.

​
Setup

1

Navigate to webhook settings

Go to Configuration > API > Webhooks.
2

Add a webhook endpoint

Enter your HTTPS endpoint URL and select the events you want to subscribe to.
3

Verify the endpoint

PG:AI will send a verification request to your endpoint. Respond with a 200 status to confirm.

​
Available events

EventDescription
account.updatedAccount intelligence has been refreshed
account.score_changedAccount score has changed
contact.addedNew contact discovered
alert.triggeredA monitoring alert has fired
enrichment.completedBatch enrichment job completed

​
Payload format

{
  "event": "account.updated",
  "timestamp": "2026-03-04T10:30:00Z",
  "data": {
    "account_id": "acc_123",
    "domain": "example.com",
    "changes": ["strategic_insights", "financial_data"]
  }
}

​
Security

Webhook payloads include a signature in the X-PGAI-Signature header. Verify this signature using your webhook secret to ensure requests are authentic.