Webhook Events

What are Webhooks?

Webhooks allow PageX to push real-time notifications to your server when events occur — no polling required.

Available Events

• **score.changed** - Your GEO score increased or decreased

• **page.optimized** - A page has been successfully optimized

• **schema.error** - A schema validation error was detected

• **citation.detected** - Your content was cited by an AI engine

• **plan.limit.approaching** - Approaching your page limit (80% threshold)

Setting Up Webhooks

1. Go to Settings > Integrations > Webhooks

2. Click "Add Webhook"

3. Enter your endpoint URL (must use HTTPS)

4. Select the events to receive

5. Save and test with the "Send Test" button

Payload Format

All webhook payloads are JSON with a consistent structure:

`{ "event": "score.changed", "timestamp": "...", "data": { ... } }`

Security

Verify webhook authenticity by checking the `X-PageX-Signature` header against an HMAC-SHA256 of the payload using your webhook secret.

Webhook Availability

Webhooks are available on Growth and Scale plans.