# molted events

Source: https://molted.email/docs/cli/events

View message event timelines

## Agent context

Message events show the full lifecycle timeline for a message: queued → sent → delivered → bounced → opened → clicked, etc.

### View all events for a message

```bash
molted events get <messageId>
# → { "events": [
#     { "id": "...", "message_id": "...", "event_type": "sent", "payload": {...}, "created_at": "..." },
#     { "id": "...", "message_id": "...", "event_type": "delivered", "payload": {...}, "created_at": "..." }
#   ]}
# Oldest first. Each event also carries tenant_id.
```

Events are recorded from the delivery provider's webhooks (plus "unsubscribed" when a recipient clicks an unsubscribe link), so they exist for outbound sends: pass the send's requestId. An inbound message id is accepted but has no events recorded today, and an unknown id returns an empty list rather than 404.

Related: [`molted send`](https://molted.email/docs/cli/send.md), [`molted trace`](https://molted.email/docs/cli/trace.md), [`molted timeline`](https://molted.email/docs/cli/timeline.md), [`molted analytics`](https://molted.email/docs/cli/analytics.md)

## Commands

### molted events get

Get all lifecycle events for a message

```bash
molted events get <messageId>
```

| Argument | Description | Required |
| - | - | - |
| `<messageId>` | | yes |

See [CLI overview](https://molted.email/docs/cli.md) for global options, credentials and output format.
