> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eventsbadge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync status

> What PENDING, ACTIVE, FAILED, and DISCONNECTED mean and how to recover from each.

> [!NOTE]
>
> Every synced event has one of four sync statuses: **PENDING** while an import or retry is running, **ACTIVE** while data is flowing live from the provider, **FAILED** when the last sync attempt errored, or **DISCONNECTED** when the integration credential is severed.

Badge tracks the health of the link between a synced event and its provider (Eventbrite or Luma) with a single sync status. An event you create in Badge has no provider, so it shows no sync status; you update its attendees with a [CSV upload](https://docs.eventsbadge.com/events/upload-csv.md). The status drives the badge on the event card, the alert at the top of the detail page, and what recovery action you're offered. Each value maps to a specific recovery action, summarized below.

## The four states

### `PENDING`

An import or re-import job is in progress, or a retry is queued. Attendees are streaming in but the live count may not match the provider yet.

You'll see this immediately after **Import Event** or after a **Retry** triggered from a failed event. Wait for the job to finish. The event page shows a progress view while a job is running.

**Edge case:** if `PENDING` persists with no active job (the initial import failed before completing), the event page surfaces an **Import failed** alert with a **Retry** button. See [Recovering from disconnect](https://docs.eventsbadge.com/events/recovering-from-disconnect.md).

### `ACTIVE`

The integration is healthy and attendee data is syncing live. New registrations, cancellations, and field edits made on the provider side flow through automatically. The event card shows a green **Synced** indicator. The event's **Attendees** table auto-refreshes every 30 seconds while this state holds.

No action needed. This is the desired steady state during the event window.

### `FAILED`

The last sync attempt errored, usually a transient provider issue or a temporary network problem. The event page shows a **Sync failed** alert with a **Retry** button.

Click **Retry** in the alert, then **Reconnect with this account** in the dialog to re-run the sync. If it keeps failing across multiple retries, contact support.

### `DISCONNECTED`

The integration credential linking this event to its provider has been severed, usually because the workspace admin revoked it on the provider side or the OAuth token expired and was not refreshed. The event page shows an **Integration disconnected** alert with a **Reconnect** button.

Recovery: reconnect the provider in **Workspace → Integrations**, then return to the event, click **Reconnect**, and confirm with **Reconnect with this account**. Full walkthrough in [Recovering from disconnect](https://docs.eventsbadge.com/events/recovering-from-disconnect.md).

## Where the status appears

* **Event list card.** Color-coded badge on each card.
* **Event detail page.** Alert banner at the top when status is `FAILED`, `DISCONNECTED`, or `PENDING` without an active job; **Synced** indicator pill in the header when `ACTIVE`.
* **Reconnect dialog.** The alert's action button opens a dialog that re-pairs the event with a connected account without leaving the page. It is titled **Reconnect Event**, or **Set Up Sync** when an import stopped partway.

## Recovery summary

| Status | What it means | Recovery |
| - | - | - |
| `PENDING` (job running) | Import or retry in progress | Wait |
| `PENDING` (no job) | Initial import failed | **Retry** in the event alert |
| `ACTIVE` | Live sync healthy | None |
| `FAILED` | Last sync errored | **Retry** in the event alert |
| `DISCONNECTED` | Integration credential severed | Reconnect the provider, then **Reconnect** the event |

## Related

* [Recovering from disconnect](https://docs.eventsbadge.com/events/recovering-from-disconnect.md). Full reconnect walkthrough for `DISCONNECTED` and stuck `FAILED` states.
* [Connect Eventbrite](https://docs.eventsbadge.com/integrations/eventbrite.md). Re-authorize the Eventbrite integration in Settings.
* [Connect Luma](https://docs.eventsbadge.com/integrations/luma.md). Reconnect the Luma integration in Settings.
* [Add an event](https://docs.eventsbadge.com/events/create.md). Pick a CONNECTED integration when adding a new event.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.