Luma API

Build custom integrations and automate your event management with the Luma API

The Luma API enables you to programmatically manage your events and calendars, allowing you to build custom integrations and automate your workflow.

Getting Started

API Documentation

The complete Luma API documentation is available at docs.luma.com. Here you'll find detailed information about all available endpoints, request/response formats, and example code.

Requirements

To use the Luma API, you'll need an active Luma Plus subscription on the calendar you want to access. Learn more about Luma Plus and its features.

Obtaining Your API Key

Your API key is specific to each calendar in your account. To find your API key:

Visit the Calendars Home and select your calendar
Navigate to Settings → Developer
Locate the API Keys section
Copy your API key to use in your integrations

Keep your API key secure and never share it publicly or commit it to version control.

What You Can Do

The Luma API provides comprehensive access to manage your events and calendars programmatically. Common tasks include:

Create and manage events - Set up new events with all details including dates, locations, and ticket types
Update event information - Modify event details, capacity, pricing, and more
Send invitations - Programmatically invite guests to your events
Manage registrations - Access guest lists, approve registrations, and handle waitlists
Retrieve analytics - Pull attendance data and event insights
Sync calendar data - Keep your external systems updated with your Luma calendar

Rate Limits

The Luma API uses a per-minute rate limit shared across read and write requests:

Calendar API keys and OAuth tokens: 200 requests per minute per calendar.
Organization API keys: 500 requests per minute per organization.

If you exceed the limit, the API returns a 429 Too Many Requests response. When building your integration, handle these responses gracefully and back off before retrying.

Need Help?

For technical questions and detailed endpoint documentation, visit docs.luma.com
For general support, contact us at [email protected]
For enterprise integrations with higher rate limits, learn about our Enterprise plan