Skip to main content

Luma

Event platform for creating and managing events, guests, tickets, coupons, contacts, and memberships on a Luma calendar.

Categories: Marketing, Scheduling, Productivity

What you can ask​

  • Create an event for our June meetup and open registration.
  • List all guests who registered for the launch party.
  • Send invites to everyone tagged as a VIP contact.
  • Add a discount coupon for early-bird ticket buyers.

Set up​

Luma connects with credentials from your Luma account. Have these values ready:

  • API key
  1. Go to Organization > Connectors and find Luma.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

Luma offers 62 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (20)​

View and search information without changing it.

ToolWhat it does
get_calendarGet the calendar this API key is scoped to: name, slug, public URL, description, images, and social handles.
get_current_userGet the Luma user this API key belongs to: user ID, name, and email.
get_eventGet one Luma event by ID: schedule, location, capacity, visibility, hosts, and guest counts.
get_guestGet one guest on an event: approval status, registration answers, tickets held, check-in QR code, and ticket purchase orders.
get_ticket_typeGet one ticket type by ID: name, free or paid, price, currency, capacity, approval requirement, and sale window.
get_webhookGet one webhook subscription: destination URL, subscribed event types, active or paused status, and the signing secret used to verify callbacks.
list_calendar_adminsList the administrators of this calendar with their names and email addresses.
list_calendar_couponsList discount coupons that apply across every event on this calendar, with cursor pagination.
list_calendar_eventsList events on this calendar with cursor pagination.
list_contact_tagsList the contact tags defined on this calendar, with their IDs, names, and colours.
list_contactsList contacts on this calendar with cursor pagination.
list_event_couponsList discount coupons scoped to one event, with cursor pagination.
list_event_tagsList the event tags defined on this calendar, with their IDs, names, and colours.
list_guestsList guests on an event with cursor pagination.
list_membership_tiersList the membership tiers on this calendar, with pricing, access rules, and the questions asked at signup.
list_ticket_typesList the ticket types on an event, including price, capacity, and sale window.
list_webhooksList the webhook subscriptions on this calendar with cursor pagination.
lookup_calendar_eventReport whether an event is on this calendar. platform is required and selects the identifier: 'luma' takes event_id or event_api_id, 'external' takes url.
lookup_entityResolve a public Luma slug to the calendar, event, or user it belongs to.
validate_credentialValidate the Luma API key with a lightweight call to the current-user endpoint.

Write (17)​

Create or send data.

ToolWhat it does
add_calendar_eventAdd an event to this calendar: an existing Luma event by event_id (platform='luma'), or an event hosted elsewhere by url (platform='external'). submission_mode='auto' approves it immediately, 'pending' leaves it for admin review.
add_guestsRegister one or more guests on an event directly, bypassing signup.
add_hostAdd a host to an event by email. access_level 'manager' can edit the event, 'check-in' can only check guests in, 'none' is listed publicly with no access; 'none' cannot be combined with is_visible=false. get_event lists only visible hosts, so a host added with is_visible=false will not appear there even though the call succeeded.
add_member_to_tierAdd someone to a membership tier by email.
apply_contact_tagApply a contact tag to contacts, identified by user_ids or emails.
apply_event_tagApply an event tag to one or more events.
create_calendar_couponCreate a discount coupon valid across every event on this calendar. discount requires a discount_type discriminator: {"discount_type": "percent", "percent_off": 20} or {"discount_type": "amount", "cents_off": 500, "currency": "usd"}.
create_contact_tagCreate a contact tag on this calendar for labelling people.
create_eventCreate an event on the calendar this API key belongs to.
create_event_couponCreate a discount coupon on one event. discount requires a discount_type discriminator: {"discount_type": "percent", "percent_off": 20} or {"discount_type": "amount", "cents_off": 500, "currency": "usd"}.
create_event_tagCreate an event tag on this calendar for grouping events.
create_image_upload_urlGet a pre-signed URL for uploading a JPEG or PNG to Luma's image host.
create_ticket_typeAdd a ticket type to an event.
create_webhookCreate a webhook subscription that POSTs to your URL when calendar activity happens.
import_contactsImport contacts onto this calendar in bulk.
request_event_cancellationStep 1 of cancelling an event.
send_guest_invitesEmail event invitations to a list of people.

Delete or overwrite (25)​

Remove or replace existing data.

ToolWhat it does
approve_calendar_eventApprove an event submitted to this calendar, making it publicly visible on the calendar page.
block_contactBlock a contact from registering for events on this calendar.
cancel_eventStep 2 of cancelling an event: permanently cancels it and notifies guests.
delete_contact_tagDelete a contact tag from this calendar.
delete_event_tagDelete an event tag from this calendar.
delete_ticket_typeDelete a ticket type from an event.
delete_webhookDelete a webhook subscription permanently, stopping all callbacks to its URL.
reject_calendar_eventReject an event submitted to this calendar, optionally with a message to the submitter.
remove_contactRemove a contact from this calendar.
remove_hostRemove a host from an event by email.
restore_contactRestore a contact previously removed or blocked on this calendar, letting them register for events again.
unapply_contact_tagRemove a contact tag from contacts, identified by user_ids or emails.
unapply_event_tagRemove an event tag from one or more events.
update_calendarUpdate the calendar's name, slug, description, avatar, or tint colour.
update_calendar_couponUpdate a calendar-wide coupon's remaining redemption count or validity window.
update_contact_tagRename a contact tag or change its colour.
update_eventUpdate an existing event.
update_event_couponUpdate an event coupon's remaining redemption count or validity window.
update_event_tagRename an event tag or change its colour.
update_guest_statusChange a guest's approval status on an event: approve them, decline them, send them back to pending_approval, or move them to the waitlist.
update_guest_ticketsAdd or remove tickets held by a guest on an event.
update_hostChange an existing host's access level or public visibility on an event.
update_member_statusApprove or decline a calendar membership, identified by Luma user ID.
update_ticket_typeUpdate a ticket type: price, name, capacity, sale window, visibility, or approval requirement.
update_webhookUpdate a webhook subscription: replace its event types, or pause and resume delivery via status. event_types replaces the existing list rather than adding to it.
⌘J