Luma

Manage events and guests on Luma

Luma is an event management platform that makes it easy to create, manage, and share events with your community.

With Luma integrated into Sim, your agents can:

  • Create events: Set up new events with name, time, timezone, description, and visibility settings.
  • Update events: Modify existing event details like name, time, description, and visibility.
  • Get event details: Retrieve full details for any event by its ID.
  • List calendar events: Browse your calendar's events with date range filtering and pagination.
  • Manage guest lists: View attendees for an event, filtered by approval status.
  • Add guests: Invite new guests to events programmatically.

By connecting Sim with Luma, you can automate event operations within your agent workflows. Automatically create events based on triggers, sync guest lists, monitor registrations, and manage your event calendar—all handled directly by your agents via the Luma API.

Whether you're running community meetups, conferences, or internal team events, the Luma tool makes it easy to coordinate event management within your Sim workflows.

Usage Instructions

Integrate Luma into the workflow. Can create events, update events, get event details, list calendar events, get guest lists, and add guests to events.

Tools

luma_get_event

Retrieve details of a Luma event including name, time, location, hosts, and visibility settings.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
eventIdstringYesEvent ID (starts with evt-)

Output

ParameterTypeDescription
eventobjectEvent details
idstringEvent ID
namestringEvent name
startAtstringEvent start time (ISO 8601)
endAtstringEvent end time (ISO 8601)
timezonestringEvent timezone (IANA)
durationIntervalstringEvent duration (ISO 8601 interval, e.g. PT2H)
createdAtstringEvent creation timestamp (ISO 8601)
descriptionstringEvent description (plain text)
descriptionMdstringEvent description (Markdown)
coverUrlstringEvent cover image URL
urlstringEvent page URL on lu.ma
visibilitystringEvent visibility (public, members-only, private)
meetingUrlstringVirtual meeting URL
geoAddressJsonjsonStructured location/address data
geoLatitudestringVenue latitude coordinate
geoLongitudestringVenue longitude coordinate
calendarIdstringAssociated calendar ID
hostsarrayEvent hosts
idstringHost ID
namestringHost display name
firstNamestringHost first name
lastNamestringHost last name
emailstringHost email address
avatarUrlstringHost avatar image URL

luma_create_event

Create a new event on Luma with a name, start time, timezone, and optional details like description, location, and visibility.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
namestringYesEvent name/title
startAtstringYesEvent start time in ISO 8601 format (e.g., 2025-03-15T18:00:00Z)
timezonestringYesIANA timezone (e.g., America/New_York, Europe/London)
endAtstringNoEvent end time in ISO 8601 format (e.g., 2025-03-15T20:00:00Z)
durationIntervalstringNoEvent duration as ISO 8601 interval (e.g., PT2H for 2 hours, PT30M for 30 minutes). Used if endAt is not provided.
descriptionMdstringNoEvent description in Markdown format
meetingUrlstringNoVirtual meeting URL for online events (e.g., Zoom, Google Meet link)
visibilitystringNoEvent visibility: public, members-only, or private (defaults to public)
coverUrlstringNoCover image URL (must be a Luma CDN URL from images.lumacdn.com)

Output

ParameterTypeDescription
eventobjectCreated event details
idstringEvent ID
namestringEvent name
startAtstringEvent start time (ISO 8601)
endAtstringEvent end time (ISO 8601)
timezonestringEvent timezone (IANA)
durationIntervalstringEvent duration (ISO 8601 interval, e.g. PT2H)
createdAtstringEvent creation timestamp (ISO 8601)
descriptionstringEvent description (plain text)
descriptionMdstringEvent description (Markdown)
coverUrlstringEvent cover image URL
urlstringEvent page URL on lu.ma
visibilitystringEvent visibility (public, members-only, private)
meetingUrlstringVirtual meeting URL
geoAddressJsonjsonStructured location/address data
geoLatitudestringVenue latitude coordinate
geoLongitudestringVenue longitude coordinate
calendarIdstringAssociated calendar ID
hostsarrayEvent hosts
idstringHost ID
namestringHost display name
firstNamestringHost first name
lastNamestringHost last name
emailstringHost email address
avatarUrlstringHost avatar image URL

luma_update_event

Update an existing Luma event. Only the fields you provide will be changed; all other fields remain unchanged.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
eventIdstringYesEvent ID to update (starts with evt-)
namestringNoNew event name/title
startAtstringNoNew start time in ISO 8601 format (e.g., 2025-03-15T18:00:00Z)
timezonestringNoNew IANA timezone (e.g., America/New_York, Europe/London)
endAtstringNoNew end time in ISO 8601 format (e.g., 2025-03-15T20:00:00Z)
durationIntervalstringNoNew duration as ISO 8601 interval (e.g., PT2H for 2 hours). Used if endAt is not provided.
descriptionMdstringNoNew event description in Markdown format
meetingUrlstringNoNew virtual meeting URL (e.g., Zoom, Google Meet link)
visibilitystringNoNew visibility: public, members-only, or private
coverUrlstringNoNew cover image URL (must be a Luma CDN URL from images.lumacdn.com)

Output

ParameterTypeDescription
eventobjectUpdated event details
idstringEvent ID
namestringEvent name
startAtstringEvent start time (ISO 8601)
endAtstringEvent end time (ISO 8601)
timezonestringEvent timezone (IANA)
durationIntervalstringEvent duration (ISO 8601 interval, e.g. PT2H)
createdAtstringEvent creation timestamp (ISO 8601)
descriptionstringEvent description (plain text)
descriptionMdstringEvent description (Markdown)
coverUrlstringEvent cover image URL
urlstringEvent page URL on lu.ma
visibilitystringEvent visibility (public, members-only, private)
meetingUrlstringVirtual meeting URL
geoAddressJsonjsonStructured location/address data
geoLatitudestringVenue latitude coordinate
geoLongitudestringVenue longitude coordinate
calendarIdstringAssociated calendar ID
hostsarrayEvent hosts
idstringHost ID
namestringHost display name
firstNamestringHost first name
lastNamestringHost last name
emailstringHost email address
avatarUrlstringHost avatar image URL

luma_list_events

List events from your Luma calendar with optional date range filtering, sorting, and pagination.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
afterstringNoReturn events after this ISO 8601 datetime (e.g., 2025-01-01T00:00:00Z)
beforestringNoReturn events before this ISO 8601 datetime (e.g., 2025-12-31T23:59:59Z)
paginationLimitnumberNoMaximum number of events to return per page
paginationCursorstringNoPagination cursor from a previous response (next_cursor) to fetch the next page of results
sortColumnstringNoColumn to sort by (only start_at is supported)
sortDirectionstringNoSort direction: asc, desc, asc nulls last, or desc nulls last

Output

ParameterTypeDescription
eventsarrayList of calendar events
idstringEvent ID
namestringEvent name
startAtstringEvent start time (ISO 8601)
endAtstringEvent end time (ISO 8601)
timezonestringEvent timezone (IANA)
durationIntervalstringEvent duration (ISO 8601 interval, e.g. PT2H)
createdAtstringEvent creation timestamp (ISO 8601)
descriptionstringEvent description (plain text)
descriptionMdstringEvent description (Markdown)
coverUrlstringEvent cover image URL
urlstringEvent page URL on lu.ma
visibilitystringEvent visibility (public, members-only, private)
meetingUrlstringVirtual meeting URL
geoAddressJsonjsonStructured location/address data
geoLatitudestringVenue latitude coordinate
geoLongitudestringVenue longitude coordinate
calendarIdstringAssociated calendar ID
hasMorebooleanWhether more results are available for pagination
nextCursorstringCursor to pass as paginationCursor to fetch the next page

luma_get_guests

Retrieve the guest list for a Luma event with optional filtering by approval status, sorting, and pagination.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
eventIdstringYesEvent ID (starts with evt-)
approvalStatusstringNoFilter by approval status: approved, session, pending_approval, invited, declined, or waitlist
paginationLimitnumberNoMaximum number of guests to return per page
paginationCursorstringNoPagination cursor from a previous response (next_cursor) to fetch the next page of results
sortColumnstringNoColumn to sort by: name, email, created_at, registered_at, or checked_in_at
sortDirectionstringNoSort direction: asc, desc, asc nulls last, or desc nulls last

Output

ParameterTypeDescription
guestsarrayList of event guests
idstringGuest ID
emailstringGuest email address
namestringGuest full name
firstNamestringGuest first name
lastNamestringGuest last name
approvalStatusstringGuest approval status (approved, session, pending_approval, invited, declined, waitlist)
registeredAtstringRegistration timestamp (ISO 8601)
invitedAtstringInvitation timestamp (ISO 8601)
joinedAtstringJoin timestamp (ISO 8601)
checkedInAtstringCheck-in timestamp (ISO 8601)
phoneNumberstringGuest phone number
hasMorebooleanWhether more results are available for pagination
nextCursorstringCursor to pass as paginationCursor to fetch the next page

luma_add_guests

Add guests to a Luma event by email. Guests are added with Going (approved) status and receive one ticket of the default ticket type.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
eventIdstringYesEvent ID (starts with evt-)
guestsstringYesJSON array of guest objects. Each guest requires an "email" field and optionally "name", "first_name", "last_name". Example: [{"email": "user@example.com", "name": "John Doe"}]

Output

ParameterTypeDescription
guestsarrayList of added guests with their assigned status and ticket info
idstringGuest ID
emailstringGuest email address
namestringGuest full name
firstNamestringGuest first name
lastNamestringGuest last name
approvalStatusstringGuest approval status (approved, session, pending_approval, invited, declined, waitlist)
registeredAtstringRegistration timestamp (ISO 8601)
invitedAtstringInvitation timestamp (ISO 8601)
joinedAtstringJoin timestamp (ISO 8601)
checkedInAtstringCheck-in timestamp (ISO 8601)
phoneNumberstringGuest phone number

On this page

Start building today
Trusted by over 70,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started