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

# Luma

> Connect Luma to Langdock to manage events, guests, and calendars from your conversations

## Overview

Luma is an event management and calendar platform. Once connected, you can use Langdock to create and manage events, handle guest lists, send invites, and manage tickets directly from your conversations.

<Info>
  **Authentication:** API Key
  **Category:** Events & Productivity
  **Availability:** All workspace plans
</Info>

## Prerequisites

* A Luma account with an active calendar

## Setup

<Steps>
  <Step title="Get your API key from Luma">
    Find your API key in [Luma's API settings](https://lu.ma/settings/api).
  </Step>

  <Step title="Navigate to Integrations in Langdock">
    Go to [Integrations](https://app.langdock.com/integrations) and find **Luma** in the list.
  </Step>

  <Step title="Enter your API key">
    Paste the API key and save.
  </Step>

  <Step title="Start using Luma in Langdock">
    Tag the integration with `@` in any agent to start managing your events and guests.
  </Step>
</Steps>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Event Management" icon="calendar">
    Create, update, and list events on your Luma calendar
  </Card>

  <Card title="Guest Management" icon="users">
    Add guests, update their status, send invites, and view attendee lists
  </Card>

  <Card title="Ticketing" icon="ticket">
    Create and manage ticket types and discount coupons for events
  </Card>

  <Card title="Calendar Overview" icon="calendar-days">
    List upcoming and past events, browse people in your calendar
  </Card>
</CardGroup>

## Troubleshooting

| Issue                     | Solution                                                                |
| ------------------------- | ----------------------------------------------------------------------- |
| **Authentication failed** | Verify the API key in Luma Settings → API                               |
| **Event not found**       | Use the list events action to find the correct event ID                 |
| **Permission denied**     | Ensure your Luma account has the necessary permissions for the calendar |