Webhooks
Receive real-time notifications when area data changes.
Receive real-time notifications when area data changes instead of polling the API.
Growth Plan Required
Webhooks are available on Growth plans and above.
Available Events
| Event | Description |
|---|---|
area.score.updated | An area's Truth Score has changed |
area.alert.triggered | A monitored area crossed a threshold |
data.source.updated | A data source has been refreshed |
Webhook Payload
JSON
{
"id": "evt_abc123",
"type": "area.score.updated",
"created_at": "2026-02-22T08:00:00Z",
"data": {
"area_id": "sandton",
"previous_score": 8.2,
"new_score": 8.4,
"changed_dimensions": ["infrastructure", "safety"]
}
}Setting Up Webhooks
Configure webhooks in your dashboard settings. You'll need to provide:
- A publicly accessible HTTPS URL
- The events you want to subscribe to
- Optional: Areas to filter (or receive all)
Verifying Webhooks
All webhooks include a signature header for verification:
Bash
X-PlaceIQ-Signature: sha256=abc123...Verify the signature by computing HMAC-SHA256 of the request body using your webhook secret.