Luma

Luma é uma plataforma de gerenciamento de eventos que facilita criar, gerenciar e compartilhar eventos com sua comunidade.

Com o Luma integrado ao Zoen, seus agentes podem:

  • Criar eventos: Configure novos eventos com nome, horário, fuso horário, descrição e configurações de visibilidade.
  • Atualizar eventos: Modifique detalhes existentes do evento, como nome, horário, descrição e visibilidade.
  • Obter detalhes do evento: Recupere os detalhes completos de qualquer evento pelo seu ID.
  • Listar eventos do calendário: Navegue pelos eventos do seu calendário com filtragem por intervalo de datas e paginação.
  • Gerenciar listas de convidados: Visualize os participantes de um evento, filtrados por status de aprovação.
  • Adicionar convidados: Convide novos convidados para eventos de forma programática.

Ao conectar o Zoen ao Luma, você pode automatizar operações de eventos dentro dos workflows dos seus agentes. Crie eventos automaticamente com base em triggers, sincronize listas de convidados, monitore registros e gerencie seu calendário de eventos — tudo tratado diretamente pelos seus agentes via API do Luma.

Seja organizando meetups da comunidade, conferências ou eventos internos de equipe, a ferramenta Luma facilita coordenar o gerenciamento de eventos dentro dos seus workflows Zoen.

Usage Instructions

Integrate Luma into the workflow. Can create, update, look up, and cancel events, list calendar events, manage guest lists (get one or many, add guests, send invites, and update approval status).

Actions

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_lookup_event

Look up an event by its public URL or event ID to resolve its canonical ID, API ID, and approval status.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
urlstringNoPublic event URL on lu.ma (provide this or an event ID)
eventIdstringNoEvent ID to look up (starts with evt-). Provide this or a URL.
platformstringNoEvent platform to look up: luma or external (defaults to luma)

Output

ParameterTypeDescription
foundbooleanWhether a matching event was found
eventIdstringResolved event ID
apiIdstringResolved event API ID (deprecated identifier)
statusstringEvent approval status (approved, pending, rejected)

luma_cancel_event

Cancel a Luma event. This is irreversible and notifies all registered guests. Requires a cancellation token obtained from the Request Event Cancellation endpoint.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
eventIdstringYesEvent ID to cancel (starts with evt-)
cancellationTokenstringYesCancellation token from the Request Event Cancellation endpoint (POST /v1/event/cancel/request)
shouldRefundbooleanNoWhether to refund paid guests. Required if the event has paid registrations.

Output

ParameterTypeDescription
cancelledbooleanWhether the event was successfully cancelled

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 from the first checked-in ticket (ISO 8601)
phoneNumberstringGuest phone number
hasMorebooleanWhether more results are available for pagination
nextCursorstringCursor to pass as paginationCursor to fetch the next page

luma_get_guest

Retrieve a single guest's details on a Luma event, including approval status, registration timestamps, and contact info.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
eventIdstringYesEvent ID the guest belongs to (starts with evt-)
guestIdentifierstringYesGuest ID (gst-...), guest key (g-...), ticket key, or the guest's email address

Output

ParameterTypeDescription
guestobjectGuest details
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 from the first checked-in ticket (ISO 8601)
phoneNumberstringGuest phone number

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
addednumberNumber of guests submitted to the event (added with Going/approved status)

luma_send_invites

Send email invitations to guests for a Luma event. Unlike Add Guests (which registers guests directly), this emails an invite that recipients can accept.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
eventIdstringYesEvent ID to invite guests to (starts with evt-)
guestsstringYesJSON array of guest objects. Each guest requires an "email" field and optionally "name". Example: [{"email": "user@example.com", "name": "John Doe"}]
messagestringNoOptional custom message included in the invite email (max 200 characters)

Output

ParameterTypeDescription
invitednumberNumber of guests invited to the event

luma_update_guest_status

Update a guest's approval status on a Luma event — approve, decline, waitlist, or set to pending. Identify the guest by email or guest ID.

Input

ParameterTypeRequiredDescription
apiKeystringYesLuma API key
eventIdstringNoEvent ID the guest belongs to (starts with evt-)
guestIdentifierstringYesGuest email address or guest ID (gst-...). Values containing '@' are treated as emails; otherwise as a guest ID.
statusstringYesNew approval status: approved, declined, pending_approval, or waitlist
shouldRefundbooleanNoRefund a paid guest when moving them out of an approved state (defaults to false)
sendEmailbooleanNoWhether to email the guest about the status change (defaults to true)

Output

ParameterTypeDescription
statusstringThe approval status applied to the guest
gueststringThe guest identifier (email or ID) that was updated

On this page