Webhooks

Ingest engagement events from Campaigner for opens, clicks, and bounces.

Monterey receives engagement events from Campaigner via a webhook endpoint. These events power the analytics dashboard and bounce tracking.

Webhook endpoint

POST /campaign-events/webhook

This endpoint accepts event payloads from Campaigner and returns 202 Accepted. Events are processed asynchronously by the EmailCampaignEngagementEventService.

Event types

Type	Description
open	Recipient opened the email
click	Recipient clicked a link
bounce	Email bounced (hard or soft)
unsubscribe	Recipient unsubscribed

Configuring Campaigner

Point Campaigner’s webhook configuration to your Monterey API’s public URL:

https://your-api-domain.com/campaign-events/webhook

The webhook endpoint does not require workspace scoping since events are matched to campaigns by their Campaigner identifiers.

Querying events

After events are ingested, query them through the events API:

curl "http://localhost:8000/campaign-events/?event_type=click&date_from=2026-03-01" \
  -H "Authorization: Bearer <token>" \
  -H "workspace_id: <workspace-id>"

Filter parameters:

Parameter	Type	Description
event_type	string	Filter by event type
date_from	ISO date	Events after this date
date_to	ISO date	Events before this date
page	integer	Page number for pagination
page_size	integer	Results per page