Troubleshooting

Dashboard looks empty

• Confirm an integration is connected or a CSV has been imported.
• Confirm at least one metric mapping is approved or active.
• Confirm a snapshot exists for the current period.
• If all three are true and it is still empty, check the freshness label.

Numbers don't match Mindbody

• Check the mapping inbox — unmapped items are excluded by design.
• Check exclusion config — staff, test, and internal records may be excluded intentionally.
• Check the mapping version on the dashboard against the version you expect.
• Reconcile against a closed period, not the open one (the open period changes).

Sync shows "error"

• Open the per-tenant Mindbody page for full diagnostics — the cross-tenant SaaS admin view never shows raw error text.
• If the underlying issue has been fixed (e.g. credentials rotated), use the Clear error action.

Safe test sync fails

• Run it as a dry run first. Dry runs do not touch raw records or change connection state.
• Confirm the site IDs configured for this tenant are correct.
• If the safe test passes but a real sync fails, check the sync run history for the entity-level breakdown.

Pilot readiness will not let me mark Ready

Ready requires every required check to pass on real data or be explicitly acknowledged. Open the per-tenant readiness page, expand each failing required check, and either fix the underlying data or acknowledge the manual checks. Recommended checks do not gate Ready.