> ## 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.

# Add an event to Badge

> Import an event from Eventbrite or Luma, or create one in Badge and upload its attendee list as a CSV.

Badge events come from one of two places. **Import Event** brings in an event from a connected provider (Eventbrite or Luma) and keeps its attendees in sync. **Create Event** makes the event in Badge, and you upload its attendee list as a CSV. Either way, the event carries a date range, a time zone, and a 6-character staff access code.

> [!NOTE]
>
> **Before you start**
>
> * A Badge workspace account. See [Members](https://docs.eventsbadge.com/administration/workspace/members.md).
> * To import: at least one **CONNECTED** integration in **Workspace → Integrations** (see [Connect Eventbrite](https://docs.eventsbadge.com/integrations/eventbrite.md) or [Connect Luma](https://docs.eventsbadge.com/integrations/luma.md)), and the event already set up in that Eventbrite or Luma account.
> * To create: your attendee list as a CSV, with an email and a unique ID for each attendee. See [Upload attendees from a CSV](https://docs.eventsbadge.com/events/upload-csv.md).

## Import from Eventbrite or Luma

**1. Open Badge → Import Event**

Sign in at [eventsbadge.com](https://eventsbadge.com), open **Events** in the sidebar, and click **Import Event** in the page header. The Import Event dialog opens.

![Events page with one upcoming event and the Create Event and Import Event buttons in the header](https://mintcdn.com/eventsbadge/sVLPHidr7TFp4nzL/images/screens/events-home.png?fit=max\&auto=format\&n=sVLPHidr7TFp4nzL\&q=85\&s=03b149ad05ee6c95a8332ccf07063b13)

The Events page

**2. Pick a provider**

The dialog shows a provider picker with one row per supported provider: **Eventbrite** and **Luma**. Each row is one of:

* **Connected.** Shows the account email and a **Select** action. Click **Select** to load events from that account.
* **Not connected.** Shows a **Connect** action. Click it to authorize the provider inline, then continue.

![Import Event dialog with an Eventbrite card and a Luma card, each with a Connect button](https://mintcdn.com/eventsbadge/sVLPHidr7TFp4nzL/images/screens/import-event-dialog.png?fit=max\&auto=format\&n=sVLPHidr7TFp4nzL\&q=85\&s=989806ac1bd33e192805b5ed946cf67c)

The provider picker before a provider is connected

**3. Pick the event**

The dialog switches to the events list for the chosen provider. Each row shows the event name and an **Import** button, except events already imported, which show **Imported** instead. Click **Import** on the event you want.

**4. Wait for the import to start**

Badge confirms with a toast (`"Import started"` and the event name) and the dialog closes. The **Events** page refreshes and the new event appears with sync status `PENDING` while attendees are pulled in the background.

**5. Open the event**

Click the new event card. If the import job is still running, the event page shows an **Import in progress** view with live progress. When the import completes, the page swaps to the full event view with stat cards, the staff access code, and a default badge template.

## Create an event in Badge

Use **Create Event** when your registrations live outside Eventbrite and Luma, for example in a spreadsheet or another ticketing tool.

**1. Open Badge → Create Event**

Open **Events** in the sidebar and click **Create Event** in the page header, next to **Import Event**.

**2. Fill in the event**

Enter a **Name**, pick a **Time Zone** (your browser's time zone is preselected), and pick the **Event Dates** on the calendar. For a one-day event, pick a single date. Each day runs from 12:00 AM to 11:59 PM in the event's time zone.

![Create Event dialog with Name, Time Zone and Event Dates fields](https://mintcdn.com/eventsbadge/sVLPHidr7TFp4nzL/images/screens/create-event-dialog.png?fit=max\&auto=format\&n=sVLPHidr7TFp4nzL\&q=85\&s=f6607b3f0586bb119dc03d95eb82e70a)

The Create Event dialog

**3. Upload your attendees**

Click **Create**. Badge confirms with `Event created` and opens the **Import attendees** wizard for the new event. Follow [Upload attendees from a CSV](https://docs.eventsbadge.com/events/upload-csv.md).

To change the name, time zone, or dates later, click **Edit** in the event page header. If you change the time zone, check-ins move to the matching days. An imported event takes these details from its provider, so edit it there.

## What you get when an event lands

Once the event is in Badge, the event detail page shows:

* **Header.** Event name, provider badge (**Manual** for an event you created), date range in the event's time zone, and, for imported events, a sync status indicator.
* **Action bar.** **Export** (attendee and badge print log CSVs; see [Export your data](https://docs.eventsbadge.com/administration/export-your-data.md#badge-event-exports)), then **Sync** for an imported event, or **Edit** and **Import CSV** for one you created. **Station mode** opens the desktop print station and **Check-in mode** the mobile check-in station. Both links use the event's access code, so you can preview what staff will see.
* **Stat cards.** Total Attendees, Checked In Today, Total Checked In.
* **Staff Access.** The 6-character access code, the staff URL, and a QR. See [Get the access code](https://docs.eventsbadge.com/staff-stations/get-access-code.md).
* **Badge Template.** Preview of the default template with a **Manage** button to open the [editor](https://docs.eventsbadge.com/templates/editor-overview.md).
* **Lead Capture.** The total leads across your sponsor booths, with a **Manage** button. See [Lead capture](https://docs.eventsbadge.com/events/lead-capture.md).
* **Attendees.** Paginated table of every attendee with check-in status and VIP flag. For an event you created, a **CSV imports** card above it lists every upload.

![Event page with stat cards, the check-ins by hour chart, and the Staff Access, Badge Template and Lead Capture cards](https://mintcdn.com/eventsbadge/sVLPHidr7TFp4nzL/images/screens/event-overview.png?fit=max\&auto=format\&n=sVLPHidr7TFp4nzL\&q=85\&s=576527d5eaddbf7353b1fd48b4cbbdee)

The event page of an event created in Badge

Inside an event the sidebar shows the event's menu, which links to the same areas: **Overview**, **Badge Templates**, **Lead Capture**, and, for an event you created, **Import CSV**. **Settings**, last in the menu, is where you turn on [welcome emails](https://docs.eventsbadge.com/events/welcome-email.md). **All events** at the top goes back to the list.

## Re-importing or replacing an event

If you imported the wrong event or want to recover one whose sync severed, the recovery dialog is the same UI:

* **DISCONNECTED** events show an alert with a **Reconnect** button. See [Recovering from disconnect](https://docs.eventsbadge.com/events/recovering-from-disconnect.md).
* **FAILED** events show a **Retry** button with the same dialog.

Importing the same event a second time doesn't duplicate it. Once `imported` is true on a candidate, the **Import** button is replaced with **Imported**.

## Related

* [Events, attendees, templates](https://docs.eventsbadge.com/concepts/events-attendees-templates.md). The three core entities and how they relate.
* [Sync status](https://docs.eventsbadge.com/concepts/sync-status.md). What `PENDING` / `ACTIVE` / `FAILED` / `DISCONNECTED` mean on the event card.
* [Import attendees](https://docs.eventsbadge.com/events/import-attendees.md). How attendees flow in after import and how to resync mid-event.
* [Upload attendees from a CSV](https://docs.eventsbadge.com/events/upload-csv.md). Fill and update an event you created in Badge.
* [Recovering from disconnect](https://docs.eventsbadge.com/events/recovering-from-disconnect.md). Reconnect an event when the credential is severed.


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