Luma
Use Luma when the user wants to discover events, view events they attend or host, inspect managed calendars and guests, or manage hosted events, registrations, invitations, and calendar contacts. Connect a personal Luma account with OAuth; access follows that account's permissions. Confirm consequential changes such as invitations, guest emails, paid memberships, and access changes before executing them. Use a calendar service for ordinary scheduling outside Luma.
Category
Pricing and payment
- Pricing
- Free in Loadout. Provider charges may apply when using a personally connected account.
- Unified payment
- Not currently supported. Connect a provider account when required.
Use Luma with AI agents
Aident Loadout lets Claude Code, Codex, Cursor, and other supported agents call Luma. Choose from 71 supported Actions. Review each execution in Audit. Connect Luma once through Aident Vault. Your agent can use the supported Actions without receiving the underlying credential.
Included Actions
- Add Calendar AdminsMake people admins of a calendar you manage, by email. Admins get full manage access to the calendar and its events. Each new admin is emailed, and anyone without a Luma account gets one; existing admins are skipped. On a Luma Plus calendar, adds that need more paid admin seats…
- Add Calendar EventList an existing event on a calendar you manage, without making the calendar a host. Pass a Luma event with `{ platform: 'luma', event_id }`, or an event hosted off Luma with `{ platform: 'external', url, name, start_at, duration_interval, timezone }` plus optional `geo_address_…
- Add Calendar To OrganizationMove a team calendar you manage into an organization you admin (see `list_organizations`). The calendar gets the organization's plan, and any Luma Plus subscription it had on its own is canceled. Personal calendars and calendars already in another organization can't be added. Re…
- Add HostAdd a host to an event you manage, by email. `manager` hosts (the default) can edit the event and its guests; `check-in` hosts can only check guests in at the door; `none` hosts appear on the event page without management access. Hidden hosts (`is_visible: false`) get access wit…
- Add Organization AdminsMake people admins of an organization you admin, by email. Organization admins get full manage access to every calendar in the organization, can add and remove other admins, and manage its plan. Each new admin is emailed, and anyone without a Luma account gets one; existing admi…
- Add Registration QuestionAdd a question guests answer when registering for an event you manage. It's appended after the existing questions; use `reorder_registration_questions` to move it. `question_type` picks the kind of answer: `text` (set `multiline` for a text area), `select` (with `options`; set `…
- Add To MembershipAdd someone by email to a free membership tier of a calendar you manage, approved right away. They're added to the calendar's contacts if they aren't already, and get the tier's welcome email, which uses one of the calendar's weekly sends. Only free tiers: paid tiers have to be…
- Apply Calendar Contact TagTag up to 500 contacts on a calendar you manage. People who aren't contacts of the calendar are skipped and counted in `skipped_count`; add them with `import_calendar_contacts` first. Contacts who already have the tag are unchanged.
- Apply Calendar Event TagTag up to 50 Luma events on a calendar you manage, including pending submissions. Pass event IDs (evt-) from `list_calendar_events`. External listings and events not on the calendar are skipped and counted in `skipped_count`. Events that already have the tag are unchanged.
- Approve Calendar EventsApprove up to 50 pending event submissions on a calendar you manage. Find submissions with `list_calendar_events` using `status: 'pending'`, then pass their `id`s. Each event becomes visible on the calendar and its submitter is notified. This preserves any management access gran…
- Create BlastEmail a message to the guests of an event you manage — now, or at `scheduled_for`. Goes to going (`approved`) guests unless you pass `recipient_groups`, which can target other statuses or only holders of a ticket type. Blasts go out in the background, count against the calendar'…
- Create CalendarCreate a team calendar you manage, for publishing a series of events and building an audience. Only the name is required; a default avatar and matching tint color are picked when omitted. Optionally set the city (`location: { type: 'lookup', query: 'Miami Beach, FL' }`), launch…
- Create Calendar Contact TagCreate a tag for organizing contacts on a calendar you manage. Tag names are unique per calendar. Apply it with `apply_calendar_contact_tag` or while importing with `import_calendar_contacts`. Returns the calendar's contact tags.
- Create Calendar Event TagCreate a tag for grouping events on a calendar you manage, such as “Workshops” or “Meetups”. Visitors can filter the calendar page by tag. Tag names are unique per calendar. Apply it with `apply_calendar_event_tag`. Returns the calendar's event tags.
- Create CouponCreate a coupon code that guests enter when registering. Pass `event_id` for one event, or `calendar_id` for a code that works on every event on the calendar; an event's own coupon with the same code takes priority. The discount is a percent, or a fixed amount in the currency's…
- Create EventCreate an event on a calendar you manage (see `list_calendars`). Events are public by default; pass `visibility` to change this. Queues a confirmation email to the host. For in-person venues, prefer `geo_address_json: { type: 'lookup', query }`; unmatched addresses are stored as…
- Create Ticket TypeAdd a ticket type to an event you manage. Returns the new ticket type.
- Delete BlastDelete a blast on an event you manage. Deleting a scheduled blast cancels the send. Deleting a sent blast removes the post from the event page, but the emails already delivered stay delivered. Confirm with the user first.
- Delete Calendar Contact TagDelete a contact tag on a calendar you manage and take it off every contact that has it. The contacts themselves stay. Confirm with the user first. Returns the calendar's remaining contact tags.
- Delete Calendar Event TagDelete an event tag on a calendar you manage and take it off every event that has it. The events themselves stay on the calendar. Confirm with the user first. Returns the calendar's remaining event tags.
- Delete Registration QuestionDelete a registration question from an event you manage. Guests' existing answers are preserved and remain visible in guest details. Confirm with the user first when the event has registrations.
- Delete Ticket TypeDelete a ticket type from an event you manage. Guests already registered with it keep their tickets, so confirm with the user first when the type has registrations. Fails if it's the event's last visible ticket type.
- Get CalendarGet information about a calendar that you have manage access for.
- Get EventGet information for an event, scoped to your role. Managers get full settings (`view: 'manage'`): the description as `description_md` markdown, hosts with contact info, `ticket_types`, `registration_questions` (with the IDs the question tools take), and `guest_counts` by status.…
- Get GuestGet detailed information for a guest on an event you manage, including contact information, registration answers, check-in code, tickets, and order and refund amounts. `id` can be the guest ID (gst-), ticket key, guest key (g-), or the user's email.
- Get SelfGet the authenticated user (the Luma account whose OAuth token is in use), including their public profile: username, bio, website, and social handles.
- Import Calendar ContactsAdd up to 500 people to the contacts of a calendar you manage, by email, so you can invite them to events and send them newsletters. Nobody is emailed. Imports run in the background and count against the calendar's import limit; people who are already contacts don't count, so re…
- Invite GuestsEmail invites to up to 100 guests for an event you manage. Sends run in the background and count against the calendar's send limit. Existing invitees and registrants are skipped; unsubscribed people and those blocking the host are also skipped and listed under `skipped`. Resolve…
- List BlastsList the blasts (emails to guests) on an event you manage, newest first. Each has the message as `content_md` markdown, its audience as `recipient_groups`, and for sent blasts the `recipient_count` and `email_open_count`. `status` is `scheduled` until the send finishes, then `se…
- +42 Actions
Related use cases
No verified related use cases are linked yet.