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

If your calendars belong to an [organization](/p/organizations), the organization has its own API keys under its **Settings → Developer** page, which give access across all of its calendars.

## 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
- **Email your guests** - Send or schedule blasts to going, invited, waitlisted, or checked-in guests
- **Manage registrations** - Access guest lists, approve registrations, and handle waitlists
- **Manage memberships** - List your [membership tiers](/p/calendar-memberships), add members to a tier, and update their status — useful for syncing members from a CRM or billing system
- **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)