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
- Go to Organization > Connectors and find Luma.
- Click Enable and choose which tools to allow.
- 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.
| Tool | What it does |
|---|---|
get_calendar | Get the calendar this API key is scoped to: name, slug, public URL, description, images, and social handles. |
get_current_user | Get the Luma user this API key belongs to: user ID, name, and email. |
get_event | Get one Luma event by ID: schedule, location, capacity, visibility, hosts, and guest counts. |
get_guest | Get one guest on an event: approval status, registration answers, tickets held, check-in QR code, and ticket purchase orders. |
get_ticket_type | Get one ticket type by ID: name, free or paid, price, currency, capacity, approval requirement, and sale window. |
get_webhook | Get one webhook subscription: destination URL, subscribed event types, active or paused status, and the signing secret used to verify callbacks. |
list_calendar_admins | List the administrators of this calendar with their names and email addresses. |
list_calendar_coupons | List discount coupons that apply across every event on this calendar, with cursor pagination. |
list_calendar_events | List events on this calendar with cursor pagination. |
list_contact_tags | List the contact tags defined on this calendar, with their IDs, names, and colours. |
list_contacts | List contacts on this calendar with cursor pagination. |
list_event_coupons | List discount coupons scoped to one event, with cursor pagination. |
list_event_tags | List the event tags defined on this calendar, with their IDs, names, and colours. |
list_guests | List guests on an event with cursor pagination. |
list_membership_tiers | List the membership tiers on this calendar, with pricing, access rules, and the questions asked at signup. |
list_ticket_types | List the ticket types on an event, including price, capacity, and sale window. |
list_webhooks | List the webhook subscriptions on this calendar with cursor pagination. |
lookup_calendar_event | Report 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_entity | Resolve a public Luma slug to the calendar, event, or user it belongs to. |
validate_credential | Validate the Luma API key with a lightweight call to the current-user endpoint. |
Write (17)
Create or send data.
| Tool | What it does |
|---|---|
add_calendar_event | Add 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_guests | Register one or more guests on an event directly, bypassing signup. |
add_host | Add 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_tier | Add someone to a membership tier by email. |
apply_contact_tag | Apply a contact tag to contacts, identified by user_ids or emails. |
apply_event_tag | Apply an event tag to one or more events. |
create_calendar_coupon | Create 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_tag | Create a contact tag on this calendar for labelling people. |
create_event | Create an event on the calendar this API key belongs to. |
create_event_coupon | Create 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_tag | Create an event tag on this calendar for grouping events. |
create_image_upload_url | Get a pre-signed URL for uploading a JPEG or PNG to Luma's image host. |
create_ticket_type | Add a ticket type to an event. |
create_webhook | Create a webhook subscription that POSTs to your URL when calendar activity happens. |
import_contacts | Import contacts onto this calendar in bulk. |
request_event_cancellation | Step 1 of cancelling an event. |
send_guest_invites | Email event invitations to a list of people. |
Delete or overwrite (25)
Remove or replace existing data.
| Tool | What it does |
|---|---|
approve_calendar_event | Approve an event submitted to this calendar, making it publicly visible on the calendar page. |
block_contact | Block a contact from registering for events on this calendar. |
cancel_event | Step 2 of cancelling an event: permanently cancels it and notifies guests. |
delete_contact_tag | Delete a contact tag from this calendar. |
delete_event_tag | Delete an event tag from this calendar. |
delete_ticket_type | Delete a ticket type from an event. |
delete_webhook | Delete a webhook subscription permanently, stopping all callbacks to its URL. |
reject_calendar_event | Reject an event submitted to this calendar, optionally with a message to the submitter. |
remove_contact | Remove a contact from this calendar. |
remove_host | Remove a host from an event by email. |
restore_contact | Restore a contact previously removed or blocked on this calendar, letting them register for events again. |
unapply_contact_tag | Remove a contact tag from contacts, identified by user_ids or emails. |
unapply_event_tag | Remove an event tag from one or more events. |
update_calendar | Update the calendar's name, slug, description, avatar, or tint colour. |
update_calendar_coupon | Update a calendar-wide coupon's remaining redemption count or validity window. |
update_contact_tag | Rename a contact tag or change its colour. |
update_event | Update an existing event. |
update_event_coupon | Update an event coupon's remaining redemption count or validity window. |
update_event_tag | Rename an event tag or change its colour. |
update_guest_status | Change 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_tickets | Add or remove tickets held by a guest on an event. |
update_host | Change an existing host's access level or public visibility on an event. |
update_member_status | Approve or decline a calendar membership, identified by Luma user ID. |
update_ticket_type | Update a ticket type: price, name, capacity, sale window, visibility, or approval requirement. |
update_webhook | Update 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. |