> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List email events

> List filtered Brevo transactional email delivery and engagement events.

`listEmailEvents` queries Brevo's granular transactional event log with offset
pagination.

## Example

```ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { listEmailEvents } from "automate.ax/brevo"

export default automation("List recent bounces", () => {
  onHttpRequest({ scope: "automation" })

  listEmailEvents({ days: 7, event: "hardBounces", limit: 500 })
})
```

## Inputs

`limit` defaults to 250 (maximum 5,000), `offset` to 0, and `sort` to `desc`.
Filter by recipient `email`, provider `event` name, `messageId`, `tags`, or
positive `templateId`. For time, use `days` (1–90) or provide both inclusive
`startDate` and `endDate` in `YYYY-MM-DD` form, never both approaches.
`account` selects the Brevo binding.

## Output

Returns `{ events: EmailEvent[] }`, where each event has `date`, `email`,
`event`, `messageId`, and optional `from`, `reason`, `tag`, and `templateId`.
The output does not include a total count or next token; advance `offset` by the
number returned when fetching another page. Provider event filter names follow
Brevo's API vocabulary and are distinct from trigger helper names.