Skip to main content Link Menu Expand (external link) Document Search Copy Copied

auth0 event-streams subscribe

Subscribe to events emitted by your tenant via Server-Sent Events (SSE).

By default, every received event is rendered as a single, color-coded summary line: TIME TYPE SOURCE EVENT-ID

Use –verbose to also print the full JSON payload after each summary, or –json / –json-compact to emit raw JSON suitable for piping into jq.

Heartbeat (offset-only) messages are suppressed by default and surfaced via a periodic faint indicator and a final cursor on disconnect; pass –show-heartbeats to render each one. Press Ctrl+C to disconnect; a per-type summary and the latest cursor will be printed so you can resume with –from.

Usage

auth0 event-streams subscribe [flags]

Examples

  auth0 event-streams subscribe
  auth0 event-streams subscribe --event-type user.created
  auth0 event-streams subscribe --event-type user.created --event-type user.updated
  auth0 event-streams subscribe --from-timestamp 2026-05-01T00:00:00Z
  auth0 event-streams subscribe --from <cursor>
  auth0 event-streams subscribe -v
  auth0 event-streams subscribe --show-heartbeats
  auth0 event-streams subscribe --output-file events.jsonl
  auth0 event-streams subscribe --json | jq .

Flags

      --event-type strings            Event type(s) to listen for. Specify multiple times for multiple types (e.g. --event-type user.created --event-type user.updated). If not provided, all event types are streamed.
      --from offset                   Opaque cursor token representing the position in the stream. If not provided, the stream starts from the latest events. Use the offset printed when the connection ends to resume from where you left off.
      --from-timestamp string         RFC-3339 timestamp indicating where to start streaming events from. Use this on the initial query when no cursor (--from) is available; prefer --from on subsequent runs as it is more accurate.
      --json                          Output each event as JSON (one indented object per event).
      --json-compact                  Output each event as compact, single-line JSON (newline-delimited).
      --output-file string            Append every received event as a JSON line to this file (raw payload). Independent of the stdout format.
      --show-heartbeats offset-only   Show every offset-only heartbeat as its own line. By default heartbeats are silently tracked and only the latest cursor is reported on disconnect.
  -v, --verbose                       Print the full JSON payload after each event summary line.

Inherited Flags

      --debug           Enable debug mode.
      --no-color        Disable colors.
      --no-input        Disable interactivity.
      --tenant string   Specific tenant to use.