# Customer events

Track product behavior and use it throughout Email Bump.

## Event model

An event connects a named customer action to an email address. Add properties for context and optional value, currency, and quantity fields for revenue reporting.

## Track an event

**POST** `/api/teams/{team_id}/track`

```json
{
  "email": "jamie@example.com",
  "event": "Purchased",
  "properties": {
    "product": "Pro plan",
    "billing_period": "annual"
  },
  "value": 249,
  "currency": "USD",
  "quantity": 1
}
```

> **Dashboard-authenticated endpoint** — The current event endpoint uses your Email Bump team session. Do not expose session credentials in browser code. A dedicated event ingestion key is planned for public client-side tracking.

## Use events

- **Trigger flows** — Start a journey when a customer acts.
- **Build segments** — Target people by behavior and properties.
- **Measure revenue** — Connect email performance to purchase value.