Skip to main content

​
Overview

Event management and calendars platform. Through Langdock’s integration, you can access and manage Luma directly from your conversations.
Authentication: API Key Category: Productivity & Collaboration Availability: All workspace plans

​
Available Actions

​
Get event

luma.get_event
Gets a single event by id Requires Confirmation: No Parameters:
  • eventId (TEXT, Required): The Luma event id
Output: Returns the operation result

​
Get guest

luma.get_guest
Gets a guest for an event by id or email Requires Confirmation: No Parameters:
  • eventId (TEXT, Required): The Luma event id
  • guestIdOrEmail (TEXT, Optional): Guest id or email of guest to get
Output: Returns the operation result

​
Get guests

luma.get_guests
Lists guests for an event Requires Confirmation: No Parameters:
  • eventId (TEXT, Required): The Luma event id
  • limit (TEXT, Optional): Maximum number of guests to return
  • fields (TEXT, Optional): Comma-separated list or JSON array of field names to return per guest. Leave empty to return all fields. Common fields: api_id, name, email, user_name, user_email, approval_status, registered_at, checked_in_at, phone_number, user_first_name, user_last_name, created_at, invited_at
Output: Returns the operation result

​
Create event

luma.create_event
Creates a new event Requires Confirmation: Yes Parameters:
  • title (TEXT, Required): Event title/name
  • start_at (TEXT, Required): ISO 8601 datetime
  • timezone (TEXT, Required): IANA timezone, e.g. America/New_York
  • visibility (SELECT, Optional): public | members-only | private
  • phone_number_requirement (SELECT, Optional): optional | required
  • name_format (SELECT, Optional): full-name | first-last
  • can_register_for_multiple_tickets (SELECT, Optional): Whether a user can register for multiple tickets
  • description_md (TEXT, Optional): Markdown description converted to Spark
  • end_at (TEXT, Optional): ISO 8601 datetime
  • max_capacity (TEXT, Optional): Maximum capacity
  • reminders_disabled (TEXT, Optional): Disable automatic reminders
  • show_guest_list (TEXT, Optional): Show approved guests list
Output: Returns the operation result

​
Update event

luma.update_event
Updates an existing event Requires Confirmation: Yes Parameters:
  • event_api_id (TEXT, Required): The Luma event id
  • title (TEXT, Optional): Event title/name
  • start_at (TEXT, Optional): ISO 8601 datetime
  • timezone (TEXT, Optional): IANA timezone, e.g. America/New_York
  • visibility (SELECT, Optional): public | members-only | private
  • phone_number_requirement (SELECT, Optional): optional | required
  • name_format (SELECT, Optional): full-name | first-last
  • can_register_for_multiple_tickets (SELECT, Optional): Whether a user can register for multiple tickets
  • description_md (TEXT, Optional): Markdown description converted to Spark
  • end_at (TEXT, Optional): ISO 8601 datetime
  • max_capacity (TEXT, Optional): Maximum capacity
  • reminders_disabled (TEXT, Optional): Disable automatic reminders
  • show_guest_list (TEXT, Optional): Show approved guests list
Output: Returns the operation result

​
Update guest status

luma.update_guest_status
Updates a guest’s status for an event Requires Confirmation: Yes Parameters:
  • event_api_id (TEXT, Required): The Luma event id
  • guest (OBJECT, Required): Guest to update (email object)
  • status (SELECT, Required): New status for the guest
  • should_refund (BOOLEAN, Optional): If declining a paid guest, refund their payment?
Output: Returns the operation result

​
Send invites

luma.send_invites
Sends event invites to guests Requires Confirmation: Yes Parameters:
  • event_api_id (TEXT, Required): The Luma event id
  • guests (OBJECT, Required): Information about the guests you want to add to the event. If a user already has a name, this will not overwrite their name.
  • message (TEXT, Optional): Personalize the message that will be included in the invite. Max of 200 characters.
Output: Returns the operation result

​
Add guests

luma.add_guests
Adds guests to an event Requires Confirmation: Yes Parameters:
  • eventId (TEXT, Required): The Luma event id
  • guests (TEXT, Required): JSON array of guest objects to add. Each guest should have an email field, e.g. [{“email”: “user@example.com”}, {“email”: “user2@example.com”}]
Output: Returns the operation result

​
Add host

luma.add_host
Adds a host to an event Requires Confirmation: Yes Parameters:
  • eventId (TEXT, Required): The Luma event id
  • hostEmail (TEXT, Required): email of the host to add
  • isVisible (BOOLEAN, Optional): Whetehr host should be visible. Defaults to true.
Output: Returns the operation result

​
Create coupon

luma.create_coupon
Creates a coupon for an event Requires Confirmation: Yes Parameters:
  • event_api_id (TEXT, Required): Event id for the coupon
  • code (TEXT, Required): Coupon code (1-20 chars)
  • percent_off (TEXT, Required): 0 to 100
  • remaining_count (TEXT, Optional): 0 to 1000000 (optional)
  • valid_start_at (TEXT, Optional): ISO 8601 datetime or null
  • valid_end_at (TEXT, Optional): ISO 8601 datetime or null
Output: Returns the operation result

​
Update coupon

luma.update_coupon
Updates an existing coupon for an event Requires Confirmation: Yes Parameters:
  • event_api_id (TEXT, Required): Event id for the coupon
  • code (TEXT, Required): Coupon code to update
  • remaining_count (TEXT, Optional): Number of remaining uses (optional)
  • valid_start_at (TEXT, Optional): ISO 8601 datetime or null (optional)
  • valid_end_at (TEXT, Optional): ISO 8601 datetime or null (optional)
Output: Returns the operation result

​
List event coupons

luma.list_event_coupons
Lists all coupons that have been created for an event Requires Confirmation: No Parameters:
  • eventId (TEXT, Required): The Luma event id (usually starts with evt-)
  • limit (TEXT, Optional): Maximum number of coupons to return
Output: Returns the operation result

​
List ticket types

luma.list_ticket_types
Lists ticket types for an event Requires Confirmation: No Parameters:
  • eventId (TEXT, Required): The Luma event id
Output: Returns the operation result

​
Get ticket type

luma.get_ticket_type
Gets a single ticket type by id Requires Confirmation: No Parameters:
  • ticketTypeId (TEXT, Required): The ticket type id
Output: Returns the operation result

​
List events

luma.list_events
Lists events for a calendar Requires Confirmation: No Parameters:
  • before (TEXT, Optional): ISO 8601 datetime upper bound
  • after (TEXT, Optional): ISO 8601 datetime lower bound
  • sortColumn (SELECT, Optional): Column to sort by
  • sortDirection (SELECT, Optional): Sort direction
  • limit (TEXT, Optional): Maximum number of events to return
Output: Returns the operation result

​
List person tags

luma.list_person_tags
Lists person tags Requires Confirmation: No Parameters:
  • limit (TEXT, Optional): Maximum number of person tags to return
Output: Returns the operation result

​
List people

luma.list_people
Lists people in a calendar Requires Confirmation: No Parameters:
  • query (TEXT, Optional): Search over names and emails
  • sortColumn (SELECT, Optional): Sort column
  • sortDirection (SELECT, Optional): Sort direction
  • limit (TEXT, Optional): Maximum number of people to return
Output: Returns the operation result

​
List calendar coupons

luma.list_calendar_coupons
Lists coupons for a calendar Requires Confirmation: No Parameters:
  • limit (TEXT, Optional): Maximum number of coupons to return
Output: Returns the operation result

​
Add event

luma.add_event
Add an existing event to the Luma calendar. Requires Confirmation: Yes Parameters:
  • eventId (TEXT, Required): The event id to add to the calendar
Output: Returns the operation result

​
Get self

luma.get_self
Returns information about the authenticated user Requires Confirmation: No Parameters: None Output: Returns the operation result

​
Lookup entity

luma.lookup_entity
Loos up an entity on Luma by it’s slug Requires Confirmation: No Parameters:
  • slug (TEXT, Required): Slug of the entity to lookup
Output: Returns the operation result