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

# Events

> Create, manage, and track events with attendee registration and check-ins

The Events API gives you full lifecycle management for any type of gathering — music festivals, conferences, meetups, product launches, and more. Create events, register attendees, track check-ins, and associate products like tickets and vouchers.

## How Events Work

```
Create Event → Create Products (tickets, perks) → Register Attendees → Check In → Redeem Items
```

Events serve as the **parent entity for products**. When you create a ticket, voucher, or perk, you associate it with an event via the `event_id` field. This lets you:

* Offer multiple product types per event (general admission, VIP, drink vouchers)
* Track inventory and sales per event
* Manage attendee registration and check-in independently from product issuance

## Event Lifecycle

| Stage        | What happens                                                                                                         |
| ------------ | -------------------------------------------------------------------------------------------------------------------- |
| **Create**   | Define your event with name, description, dates, location, and an optional `reference_id` to link to your own system |
| **Manage**   | Update event details or delete events as plans change                                                                |
| **Products** | Create tickets, perks, and vouchers linked to your event via the [Products API](/docs/products/introduction)         |
| **Register** | Register users as attendees with optional `registered_at` and `checked_in_at` timestamps                             |
| **Check-in** | Update attendee records when they arrive at the venue                                                                |

## Key Features

<CardGroup cols={2}>
  <Card title="Flexible Lookup" icon="magnifying-glass">
    Fetch events by Mufi UUID or your own custom `reference_id` — integrate seamlessly with your existing systems.
  </Card>

  <Card title="Attendee Tracking" icon="clipboard-check">
    Track registration and check-in timestamps independently. Safe to call repeatedly — existing records are updated, not duplicated.
  </Card>

  <Card title="Multi-Product Events" icon="layer-group">
    Associate multiple product types (admission, presale, perks) with a single event for complete event monetization.
  </Card>

  <Card title="Full CRUD" icon="pen-to-square">
    Create, read, update, and delete events. List all events with pagination or fetch individual events by ID.
  </Card>
</CardGroup>

## Quick Example

Create an event and register an attendee:

<CodeGroup>
  ```bash cURL theme={null}
  # Create an event
  curl -X POST https://api.mufi.app/v1/events/create \
    -H "Authorization: Bearer $MUFI_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Summer Festival",
      "location": "Miami, FL",
      "address": "123 Ocean Drive",
      "start_date": 1756684800,
      "end_date": 1756857600
    }'

  # Register an attendee
  curl -X POST https://api.mufi.app/v1/events/attendees/register \
    -H "Authorization: Bearer $MUFI_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "event_id": "EVENT_ID",
      "user_id": "USER_ID",
      "registered_at": 1756684800
    }'
  ```
</CodeGroup>

## Learn More

<CardGroup cols={2}>
  <Card title="Events API Reference" icon="calendar" href="/docs/events/introduction">
    Full API documentation with all endpoints, parameters, and response schemas.
  </Card>

  <Card title="Products Overview" icon="box" href="/docs/products-overview">
    Learn how to create tickets, vouchers, and perks for your events.
  </Card>
</CardGroup>