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

# Luma source

> Connect Luma to Chartcastr for automated event registration, attendance, and calendar subscriber charts delivered to Slack or email.

<Info>
  **Free + Paid** — Total Events is available on every Chartcastr plan. The other nine Luma metrics are gated to Pro+. [See pricing](https://chartcastr.com/pricing).
</Info>

<Warning>
  **Luma Plus required** — To use the Luma API, you'll need an active [Luma Plus](https://lu.ma/plus) subscription on the calendar you want to access. See Luma's [API overview](https://help.luma.com/p/luma-api) for details.
</Warning>

## Overview

Use Luma as a data source for Chartcastr. Connect your Luma calendar to turn your event programme into scheduled charts: event counts, registrations per event, average check-in rate, and calendar subscriber growth.

Chartcastr connects with read-only access to the Luma REST API using a per-calendar API key.

## Setup

<Steps>
  <Step title="Confirm Luma Plus is active">
    The Luma API is only available on calendars with an active [Luma Plus](https://lu.ma/plus) subscription. Without it, the **Developer** tab will not expose an API key.
  </Step>

  <Step title="Open your calendar in Luma">
    Sign in at [lu.ma](https://lu.ma), open **Calendars Home**, and select the calendar you want to chart. API keys are per-calendar, not per-account.
  </Step>

  <Step title="Generate an API key">
    In the calendar, go to **Settings → Developer**, find the **API Keys** section, and copy your key. Chartcastr passes this via the `x-luma-api-key` header on every call. Keep the key secure — never share it publicly or commit it to version control.
  </Step>

  <Step title="Connect in Chartcastr">
    In Chartcastr, create a new source and choose **Luma**. Paste the API key. Chartcastr validates the key against `GET /v1/calendar/list-events` before saving.
  </Step>

  <Step title="Pick a metric">
    Choose the Luma metric you want to chart. Each metric becomes its own source you can route to Slack or email on any schedule.
  </Step>
</Steps>

## Available Metrics

<CardGroup cols={3}>
  <Card title="Events" icon="calendar">
    Total events, upcoming pipeline, recent events, and a 12-month monthly trend.
  </Card>

  <Card title="Guests" icon="users">
    Total registrations, top events by registration count, average check-in rate, and recent registrations.
  </Card>

  <Card title="People" icon="user-plus">
    Calendar subscriber count and 90-day subscriber growth trend.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/luma/available-charts">
  See the full list of Luma metrics with chart types and tier requirements.
</Card>

## How the connection works

* **Auth**: per-calendar API key sent via the `x-luma-api-key` header. Encrypted at rest using AES-256-GCM and never sent to the browser after setup.
* **Base URL**: `https://public-api.luma.com`
* **Endpoints used**: `/v1/calendar/list-events`, `/v1/calendar/list-people`, `/v1/event/get-guests`
* **Pagination**: cursor-based; Chartcastr walks pages with a safety cap of 2,000 entries per fetch.
* **Rate limit**: Luma allows 200 req/min per calendar key (500 req/min per organization key). Chartcastr's per-metric fetches stay well under this.

## Disconnecting

Open **Admin → Settings → Sources → Luma** and click **Disconnect**. This archives all Luma sources for the org and revokes Chartcastr's stored API key.

## References

* [Luma API overview](https://help.luma.com/p/luma-api) — official prerequisites, key location, and rate-limit policy
* [Luma developer docs](https://docs.luma.com) — endpoint reference
* [Luma Plus](https://lu.ma/plus) — subscription required to access the API