GET https://api.usecommune.com/newsletters/{newsletter}/events Production. There is no separate sandbox host.

List a newsletter's engagement events

The raw engagement stream the insight scores are built from, with both origins unified into one vocabulary: what a reader did inside the community, and what the newsletter's email provider reported about the same person. source says which side an event came from.

These are engagement records, not the events Commune pushes to a consumer. They describe reader behaviour and are read on request. What Commune pushes is the webhooks block of this document.

Ordered by id descending, and the cursor walks the same key, so a warehouse can tail this collection and be sure that nothing inserted mid page is skipped.

Every event is attributed to a Commune account, so a subscriber the newsletter knows only as an email address never appears here even when the provider reported an open for that address.

Needs insights: read. A newsletter whose plan does not include insights answers 402.

Path parameters

  • string Required

Query parameters

  • string
  • integer
  • string
  • string
  • string
  • string

Request Headers

  • string
GET /newsletters/{newsletter}/events
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-listnewsletterevents

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.