Event catalog

Every event Aigeon fires is listed here with its event_name value and a description of the data payload.

Engagement

emailOpen

A recipient opened an email (pixel load recorded by an Aigeon tracking server).

{
  "contact_email": "alice@example.com",
  "flow_id": "flw_abc",
  "campaign_id": null,
  "email_send_id": "es_xyz",
  "user_agent": "Mozilla/5.0 ...",
  "ip": "203.0.113.5",
  "device_type": "mobile"
}

emailClick

A tracked link was clicked. link_url is the destination.

{
  "contact_email": "alice@example.com",
  "flow_id": "flw_abc",
  "email_send_id": "es_xyz",
  "link_url": "https://example.com/product",
  "link_alias": "cta-button"
}

emailAdImp

An ad slot in the email was rendered/viewed.

emailAdClick

A click on an Aigeon-served ad slot.

emailImageRender

A non-tracking image in the email was fetched (useful for render-time analytics).

pollVote

A contact submitted a one-click poll embedded in the email.

{
  "contact_email": "alice@example.com",
  "poll_id": "poll_abc",
  "option_id": "opt_1",
  "option_label": "Very likely"
}

Deliverability

emailHardBounce

A permanent delivery failure (e.g. address doesn't exist). Aigeon suppresses future sends to this address automatically.

{
  "contact_email": "bob@example.com",
  "bounce_reason": "550 5.1.1 The email account that you tried to reach does not exist",
  "sending_domain": "mail.example.com"
}

emailSoftBounce

A transient delivery failure (mailbox full, server temporarily unavailable). Aigeon retries soft bounces before marking them permanent.

emailComplaint

The recipient reported the email as spam via their mail client.

{
  "contact_email": "carol@example.com",
  "complaint_feedback_type": "abuse"
}

Subscription lifecycle

emailUnsubscribe

A contact unsubscribed from a specific flow — they will no longer receive emails from that flow.

{
  "contact_email": "alice@example.com",
  "flow_id": "flw_weekly",
  "method": "link_click"
}

emailUnsubscribeAll

A contact clicked Unsubscribe from all — a global opt-out from every flow in your org.

emailClickUnsubscribePage

A contact clicked the unsubscribe link but hasn't confirmed yet (landed on the unsubscribe landing page).

Partner & acquisition

sparkloopSubscribeClick

A referred subscriber click from the SparkLoop integration.

userAcquisitionClickSub

A user acquisition network recorded a new subscription click.

userAcquisitionClickUnsub

A user acquisition network recorded an unsubscription click.

New event types are announced in the changelog. Subscribe to the * wildcard when registering your webhook to automatically receive future event types without reconfiguring.