canonical: https://jentic.com/apis/luma.com/luma

# Luma API

The Luma API exposes Luma's events platform - calendars, events, guests, ticket types, coupons, person tags, and admin operations. The 55 endpoints let third-party tools list events on a calendar, look up or invite guests, manage ticket types and coupons, and read calendar membership and tags. Authentication uses an x-luma-api-key header generated from the Luma dashboard.

## For AI agents

List events on a Luma calendar, look up guests and ticket types, manage coupons and person tags, and orchestrate event RSVPs.

## Scope

Does not handle payment processing, marketing email blasts, or video conferencing - use for Luma event, calendar, guest, ticket type, and coupon read operations only.

## Capabilities

- List events on a calendar with filters and pagination via /v1/calendar/list-events
- Retrieve a single event with /v1/event/get and look up specific guests or the full guest list
- Manage ticket types and event coupons including listing, creating, and querying coupon usage
- List people on a calendar and the person tags applied to them for segmentation
- Look up calendar admins and event tags applied across the calendar
- Resolve a Luma URL or identifier to its underlying entity via /v1/entity/lookup

## Use cases

### Sync Luma events into a CRM or BI tool

Marketing and growth teams pipe Luma events and guest lists into HubSpot, Salesforce, or a warehouse to attribute leads back to the events they attended. /v1/calendar/list-events pulls the event roster, /v1/event/get-guests pulls the guest list per event, and /v1/calendar/list-person-tags pulls segmentation tags. The result is event-level attendance plus tags ready for downstream segmentation.

Example prompt: Call /v1/calendar/list-events for the next 30 days, then for each event call /v1/event/get-guests and write the guest emails plus ticket type to the CRM.

### Coupon and ticket-type management for promo campaigns

Event organisers running promo campaigns need to list and create coupons across a calendar or against a specific event, and confirm which ticket types are available. /v1/calendar/coupons and /v1/event/coupons cover coupon listing at both scopes, while /v1/event/ticket-types/list returns the currently configured ticket types for an event. Operations teams use this to keep coupon codes in sync with email and social campaigns.

Example prompt: List the active coupons on calendar 'cal-xyz' via /v1/calendar/coupons and return the codes plus their remaining redemptions.

### Resolve Luma URLs into structured event data

Tools that ingest event URLs from emails or chat need to resolve them into structured Luma data without scraping. /v1/entity/lookup and /v1/calendar/lookup-event take an identifier or URL and return the underlying calendar or event entity. This lets a chatbot or agent answer 'what's on this event link?' with first-party data.

Example prompt: Pass a Luma event URL to /v1/calendar/lookup-event and return the structured event title, time, and location.

### Agent-driven event check-ins via Jentic

An AI assistant for an event organiser is asked 'who is coming tomorrow and have they paid?'. Jentic stores the x-luma-api-key in your Jentic One instance and exposes the Luma operations by intent so the agent can chain list-events, get-guests, and ticket-types without holding the raw key.

Example prompt: Search Jentic for 'list luma upcoming events', execute it for the next 24 hours, then chain /v1/event/get-guests for each event.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /v1/calendar/list-events | List events on a calendar |
| GET | /v1/event/get | Get a single event by ID |
| GET | /v1/event/get-guests | Get the full guest list for an event |
| GET | /v1/event/get-guest | Get a specific guest on an event |
| GET | /v1/event/ticket-types/list | List ticket types configured for an event |
| GET | /v1/calendar/coupons | List coupons on a calendar |
| GET | /v1/entity/lookup | Resolve a Luma URL or identifier to its entity |

## Key resources

- **Calendar** — Calendar metadata, list events, list people, list person tags, list event tags, list admins, list and lookup events, calendar coupons
- **Event** — Event detail, guest lookup, full guest list, event ticket types, event coupons
- **User** — Authenticated user metadata via /v1/user/get-self
- **Entity** — Generic entity lookup by identifier or URL

## Why Jentic

- **Setup:** Wiring the Luma API by hand means sending the x-luma-api-key header on every request and mapping one key across calendar, event, guest, ticket-type, and coupon read paths. Through Jentic you install once, import the Luma API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which Luma operations the agent may call, so you can limit it to the read operations it needs, such as listing calendar events or getting an event guest list, and leave out the rest. The agent only reaches the operations in the set you allow.
- **Credential handling:** Your Luma key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list Luma upcoming events' or 'get an event guest list', and Jentic returns the matching Luma operation with its parameter schema so the agent calls the right endpoint directly.

## Related APIs

- **Meetup** — Community events platform with groups, events, and RSVPs
- **Cvent** — Enterprise event management platform for large conferences
- **Calendly** — 1:1 and team scheduling for booked meetings

## FAQ

### What authentication does the Luma API use?

The Luma API uses an x-luma-api-key header. Generate the key from your Luma dashboard and send it on every request to public-api.luma.com. Through Jentic, the key is stored encrypted in your Jentic One instance and injected per request - the agent never sees the raw key.

### Can I list all upcoming events on a calendar with the Luma API?

Yes. Call GET /v1/calendar/list-events with the calendar identifier and a time range. For a single event by ID use GET /v1/event/get, and for resolving an event URL use /v1/calendar/lookup-event.

### What are the rate limits for the Luma API?

Specific rate limits are not declared in the OpenAPI spec. Expect per-account fair-use limits - design clients to retry on 429 responses and avoid full-calendar guest list polling more often than once per minute per event.

### How do I pull an event's guest list through Jentic?

Search Jentic for 'luma event guests', load GET /v1/event/get-guests, and execute it with the event ID. The x-luma-api-key is injected automatically and the response gives you the guest emails, RSVP state, and ticket type.

### Does the Luma API support creating events programmatically?

The 55 endpoints in this spec focus on read access to events, calendars, guests, tags, ticket types, and coupons. If you need to create an event itself, do so in the Luma dashboard and use this API to read and integrate it into downstream tools.

### Can I limit what my agent is allowed to do with the Luma API?

Yes. Because Jentic One is self-hosted, you decide which Luma operations the agent may call, so you can restrict it to just the read paths it needs, such as GET /v1/calendar/list-events and GET /v1/event/get-guests, and leave out ticket-type or coupon operations. Your own rules define the allowed operation set and control the x-luma-api-key, so the agent can only reach the endpoints you permit and never handles the raw key. If a request falls outside that set, the agent cannot call it.