Skip to main content

Platform Outbox

Monitor and manage platform-level events that must reach downstream systems (CRM, analytics, notifications).

Last updated: 2026-01-26 Where to find it: Admin > Platform Outbox Who can use it: Admin roles with technical access Prerequisites: Admin access, technical understanding of event systems Help link: /admin/platform-outbox

Overview

Platform outbox entries are not tied to a specific club and are processed by the TeeTime outbox worker.

What you'll see (fields/columns)

Metrics

MetricDescription
PendingEvents waiting to be processed
ProcessedSuccessfully delivered events
FailedEvents that failed delivery
Dead-letteredEvents exceeding max retry attempts
LagAge of oldest pending event

Entries List

ColumnTypeDescription
IDTextEntry reference
Event TypeBadgeType of event
TenantTextAssociated tenant
StatusBadgePending, Processed, Failed, Dead-lettered
CreatedTimestampWhen event was created

How to do it

Requeue Failed Entries

  1. Filter entries by Failed status.
  2. Review error details.
  3. Fix upstream issue if needed.
  4. Click Requeue to retry.

Bulk Requeue

  1. Filter by status or event type.
  2. Select entries to requeue.
  3. Click Bulk Requeue.
  4. Confirm the action.

Purge Old Entries

  1. Set retention window filter.
  2. Select processed entries to purge.
  3. Click Purge.
  4. Confirm deletion.

Screenshot / Callout

Platform Outbox

Expected outcome

  • Events are delivered to downstream systems.
  • Failed entries are investigated and requeued.
  • Lag remains minimal during normal operations.

Troubleshooting

  • Lag increasing? Check worker health and queue depth.
  • Repeated failures? Inspect entry payload and error, then requeue after fix.
  • Dead-lettered entries? Review error message and max attempts, then requeue if safe.
  • Wallets — Wallet transaction outbox
  • Reports — System health reports