Skip to main content

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.

Free + Paid — Total Events is available on every Chartcastr plan. The other nine Luma metrics are gated to Pro+. See pricing.
Luma Plus required — To use the Luma API, you’ll need an active Luma Plus subscription on the calendar you want to access. See Luma’s API overview for details.

​
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

1

Confirm Luma Plus is active

The Luma API is only available on calendars with an active Luma Plus subscription. Without it, the Developer tab will not expose an API key.
2

Open your calendar in Luma

Sign in at lu.ma, open Calendars Home, and select the calendar you want to chart. API keys are per-calendar, not per-account.
3

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

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

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.

​
Available Metrics

Events

Total events, upcoming pipeline, recent events, and a 12-month monthly trend.

Guests

Total registrations, top events by registration count, average check-in rate, and recent registrations.

People

Calendar subscriber count and 90-day subscriber growth trend.

View all available charts

See the full list of Luma metrics with chart types and tier requirements.

​
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