Overview
Add Luma to any ModuleX agent or workflow. Event management platform for creating, managing, and tracking events and guests via the Luma REST API (public-api.luma.com/v1).
Categories: Scheduling & Events · Events · Productivity & Collaboration · Marketing · Auth: API Key · Actions: 8
Authentication
API Key Authentication
Authenticate using your Luma API key1
Step 1
Go to https://lu.ma and sign in to your account
2
Step 2
Navigate to your calendar settings or developer section
3
Step 3
Generate or copy your API key
4
Step 4
Paste the API key below
Required Credentials
Available Actions
create_event — Create an event on the connected Luma calendar
create_event — Create an event on the connected Luma calendar
Parameters
string
required
The event name
string
required
The event start time as an ISO 8601 datetime, for example 2026-05-15T18:00:00Z
string
required
The IANA timezone for the event, for example America/New_York
string
The event end time as an ISO 8601 datetime
string
Markdown description for the event
string
Event visibility: public, members-only, or private
string
Custom event URL slug
string
Online meeting URL for a virtual event
string
Cover image URL uploaded to the Luma CDN
integer
Maximum number of registrations before the event is sold out
boolean
Whether guests can register for multiple tickets
boolean
Whether approved guests can see who else is attending
boolean
Whether to disable default event reminders
string
How to collect guest names: full-name or first-last
string
Phone number collection: optional or required
string
A hex color like #bb2dc7 for the event theme
string
JSON object with latitude and longitude for the event location
string
JSON object with address details (type, place_id, description)
string
JSON array of registration question objects with label and required fields
string
JSON object with subject and message for the post-event feedback email
Response
get_event — Get admin details for a Luma event by event ID
get_event — Get admin details for a Luma event by event ID
list_events — List events managed by the connected Luma calendar
list_events — List events managed by the connected Luma calendar
Parameters
string
Return events starting after this ISO 8601 datetime
string
Return events starting before this ISO 8601 datetime
string
The next_cursor value from a previous list response
integer
Number of items to request per page (Default:
50)string
Calendar submission status: approved or pending
string
Column to sort by (currently only start_at is supported)
string
Sort order: asc, desc, asc nulls last, or desc nulls last
Response
get_guest — Get detailed information for a Luma event guest by ID or email
get_guest — Get detailed information for a Luma event guest by ID or email
get_guests — List guests registered for, invited to, or waitlisted for a Luma event
get_guests — List guests registered for, invited to, or waitlisted for a Luma event
Parameters
string
required
The Luma event ID (usually starts with evt-)
string
Filter by status: approved, session, pending_approval, invited, declined, or waitlist
string
The next_cursor value from a previous list response
integer
Number of items to request per page (Default:
50)string
Guest field to sort by: name, email, created_at, registered_at, or checked_in_at
string
Sort order: asc, desc, asc nulls last, or desc nulls last
Response
add_guests — Add guests to a Luma event with status Going
add_guests — Add guests to a Luma event with status Going
Parameters
string
required
The Luma event ID (usually starts with evt-)
string
required
JSON array of guests, each with at least an email field
string
JSON object assigning one ticket type to each guest (mutually exclusive with tickets_json)
string
JSON array assigning multiple tickets to each guest (mutually exclusive with ticket_json)
Response
list_ticket_types — List ticket types for a Luma event
list_ticket_types — List ticket types for a Luma event
Limits & Quotas
- No documented public rate limits; Luma enforces server-side pagination maximums.
- Error model: non-2xx responses and timeouts are caught and returned as
success=False+errorrather than raising.