---
title: "Luma API"
subtitle: "Build custom integrations and automate your event management with the Luma API"
slug: "luma-api"
url: "https://help.luma.com/p/luma-api"
tags: ["Integrations"]
---

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](https://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](https://luma.com/pricing) and its features.

## Obtaining Your API Key

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

1. Visit the [Calendars Home](https://luma.com/home/calendars) and select your calendar
2. Navigate to **Settings → Developer**
3. Locate the **API Keys** section
4. 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](https://docs.luma.com)
- For general support, contact us at support@luma.com
- For enterprise integrations with higher rate limits, learn about our [Enterprise plan](mailto:support@luma.com)