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.
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).
Retrieve details of a Luma event including name, time, location, hosts, and visibility settings.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
eventId | string | Yes | Event ID (starts with evt-) |
| Parameter | Type | Description |
|---|
event | object | Event details |
↳ id | string | Event ID |
↳ name | string | Event name |
↳ startAt | string | Event start time (ISO 8601) |
↳ endAt | string | Event end time (ISO 8601) |
↳ timezone | string | Event timezone (IANA) |
↳ durationInterval | string | Event duration (ISO 8601 interval, e.g. PT2H) |
↳ createdAt | string | Event creation timestamp (ISO 8601) |
↳ description | string | Event description (plain text) |
↳ descriptionMd | string | Event description (Markdown) |
↳ coverUrl | string | Event cover image URL |
↳ url | string | Event page URL on lu.ma |
↳ visibility | string | Event visibility (public, members-only, private) |
↳ meetingUrl | string | Virtual meeting URL |
↳ geoAddressJson | json | Structured location/address data |
↳ geoLatitude | string | Venue latitude coordinate |
↳ geoLongitude | string | Venue longitude coordinate |
↳ calendarId | string | Associated calendar ID |
hosts | array | Event hosts |
↳ id | string | Host ID |
↳ name | string | Host display name |
↳ firstName | string | Host first name |
↳ lastName | string | Host last name |
↳ email | string | Host email address |
↳ avatarUrl | string | Host avatar image URL |
Create a new event on Luma with a name, start time, timezone, and optional details like description, location, and visibility.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
name | string | Yes | Event name/title |
startAt | string | Yes | Event start time in ISO 8601 format (e.g., 2025-03-15T18:00:00Z) |
timezone | string | Yes | IANA timezone (e.g., America/New_York, Europe/London) |
endAt | string | No | Event end time in ISO 8601 format (e.g., 2025-03-15T20:00:00Z) |
durationInterval | string | No | Event duration as ISO 8601 interval (e.g., PT2H for 2 hours, PT30M for 30 minutes). Used if endAt is not provided. |
descriptionMd | string | No | Event description in Markdown format |
meetingUrl | string | No | Virtual meeting URL for online events (e.g., Zoom, Google Meet link) |
visibility | string | No | Event visibility: public, members-only, or private (defaults to public) |
coverUrl | string | No | Cover image URL (must be a Luma CDN URL from images.lumacdn.com) |
| Parameter | Type | Description |
|---|
event | object | Created event details |
↳ id | string | Event ID |
↳ name | string | Event name |
↳ startAt | string | Event start time (ISO 8601) |
↳ endAt | string | Event end time (ISO 8601) |
↳ timezone | string | Event timezone (IANA) |
↳ durationInterval | string | Event duration (ISO 8601 interval, e.g. PT2H) |
↳ createdAt | string | Event creation timestamp (ISO 8601) |
↳ description | string | Event description (plain text) |
↳ descriptionMd | string | Event description (Markdown) |
↳ coverUrl | string | Event cover image URL |
↳ url | string | Event page URL on lu.ma |
↳ visibility | string | Event visibility (public, members-only, private) |
↳ meetingUrl | string | Virtual meeting URL |
↳ geoAddressJson | json | Structured location/address data |
↳ geoLatitude | string | Venue latitude coordinate |
↳ geoLongitude | string | Venue longitude coordinate |
↳ calendarId | string | Associated calendar ID |
hosts | array | Event hosts |
↳ id | string | Host ID |
↳ name | string | Host display name |
↳ firstName | string | Host first name |
↳ lastName | string | Host last name |
↳ email | string | Host email address |
↳ avatarUrl | string | Host avatar image URL |
Update an existing Luma event. Only the fields you provide will be changed; all other fields remain unchanged.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
eventId | string | Yes | Event ID to update (starts with evt-) |
name | string | No | New event name/title |
startAt | string | No | New start time in ISO 8601 format (e.g., 2025-03-15T18:00:00Z) |
timezone | string | No | New IANA timezone (e.g., America/New_York, Europe/London) |
endAt | string | No | New end time in ISO 8601 format (e.g., 2025-03-15T20:00:00Z) |
durationInterval | string | No | New duration as ISO 8601 interval (e.g., PT2H for 2 hours). Used if endAt is not provided. |
descriptionMd | string | No | New event description in Markdown format |
meetingUrl | string | No | New virtual meeting URL (e.g., Zoom, Google Meet link) |
visibility | string | No | New visibility: public, members-only, or private |
coverUrl | string | No | New cover image URL (must be a Luma CDN URL from images.lumacdn.com) |
| Parameter | Type | Description |
|---|
event | object | Updated event details |
↳ id | string | Event ID |
↳ name | string | Event name |
↳ startAt | string | Event start time (ISO 8601) |
↳ endAt | string | Event end time (ISO 8601) |
↳ timezone | string | Event timezone (IANA) |
↳ durationInterval | string | Event duration (ISO 8601 interval, e.g. PT2H) |
↳ createdAt | string | Event creation timestamp (ISO 8601) |
↳ description | string | Event description (plain text) |
↳ descriptionMd | string | Event description (Markdown) |
↳ coverUrl | string | Event cover image URL |
↳ url | string | Event page URL on lu.ma |
↳ visibility | string | Event visibility (public, members-only, private) |
↳ meetingUrl | string | Virtual meeting URL |
↳ geoAddressJson | json | Structured location/address data |
↳ geoLatitude | string | Venue latitude coordinate |
↳ geoLongitude | string | Venue longitude coordinate |
↳ calendarId | string | Associated calendar ID |
hosts | array | Event hosts |
↳ id | string | Host ID |
↳ name | string | Host display name |
↳ firstName | string | Host first name |
↳ lastName | string | Host last name |
↳ email | string | Host email address |
↳ avatarUrl | string | Host avatar image URL |
List events from your Luma calendar with optional date range filtering, sorting, and pagination.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
after | string | No | Return events after this ISO 8601 datetime (e.g., 2025-01-01T00:00:00Z) |
before | string | No | Return events before this ISO 8601 datetime (e.g., 2025-12-31T23:59:59Z) |
paginationLimit | number | No | Maximum number of events to return per page |
paginationCursor | string | No | Pagination cursor from a previous response (next_cursor) to fetch the next page of results |
sortColumn | string | No | Column to sort by (only start_at is supported) |
sortDirection | string | No | Sort direction: asc, desc, asc nulls last, or desc nulls last |
| Parameter | Type | Description |
|---|
events | array | List of calendar events |
↳ id | string | Event ID |
↳ name | string | Event name |
↳ startAt | string | Event start time (ISO 8601) |
↳ endAt | string | Event end time (ISO 8601) |
↳ timezone | string | Event timezone (IANA) |
↳ durationInterval | string | Event duration (ISO 8601 interval, e.g. PT2H) |
↳ createdAt | string | Event creation timestamp (ISO 8601) |
↳ description | string | Event description (plain text) |
↳ descriptionMd | string | Event description (Markdown) |
↳ coverUrl | string | Event cover image URL |
↳ url | string | Event page URL on lu.ma |
↳ visibility | string | Event visibility (public, members-only, private) |
↳ meetingUrl | string | Virtual meeting URL |
↳ geoAddressJson | json | Structured location/address data |
↳ geoLatitude | string | Venue latitude coordinate |
↳ geoLongitude | string | Venue longitude coordinate |
↳ calendarId | string | Associated calendar ID |
hasMore | boolean | Whether more results are available for pagination |
nextCursor | string | Cursor to pass as paginationCursor to fetch the next page |
Look up an event by its public URL or event ID to resolve its canonical ID, API ID, and approval status.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
url | string | No | Public event URL on lu.ma (provide this or an event ID) |
eventId | string | No | Event ID to look up (starts with evt-). Provide this or a URL. |
platform | string | No | Event platform to look up: luma or external (defaults to luma) |
| Parameter | Type | Description |
|---|
found | boolean | Whether a matching event was found |
eventId | string | Resolved event ID |
apiId | string | Resolved event API ID (deprecated identifier) |
status | string | Event approval status (approved, pending, rejected) |
Cancel a Luma event. This is irreversible and notifies all registered guests. Requires a cancellation token obtained from the Request Event Cancellation endpoint.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
eventId | string | Yes | Event ID to cancel (starts with evt-) |
cancellationToken | string | Yes | Cancellation token from the Request Event Cancellation endpoint (POST /v1/event/cancel/request) |
shouldRefund | boolean | No | Whether to refund paid guests. Required if the event has paid registrations. |
| Parameter | Type | Description |
|---|
cancelled | boolean | Whether the event was successfully cancelled |
Retrieve the guest list for a Luma event with optional filtering by approval status, sorting, and pagination.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
eventId | string | Yes | Event ID (starts with evt-) |
approvalStatus | string | No | Filter by approval status: approved, session, pending_approval, invited, declined, or waitlist |
paginationLimit | number | No | Maximum number of guests to return per page |
paginationCursor | string | No | Pagination cursor from a previous response (next_cursor) to fetch the next page of results |
sortColumn | string | No | Column to sort by: name, email, created_at, registered_at, or checked_in_at |
sortDirection | string | No | Sort direction: asc, desc, asc nulls last, or desc nulls last |
| Parameter | Type | Description |
|---|
guests | array | List of event guests |
↳ id | string | Guest ID |
↳ email | string | Guest email address |
↳ name | string | Guest full name |
↳ firstName | string | Guest first name |
↳ lastName | string | Guest last name |
↳ approvalStatus | string | Guest approval status (approved, session, pending_approval, invited, declined, waitlist) |
↳ registeredAt | string | Registration timestamp (ISO 8601) |
↳ invitedAt | string | Invitation timestamp (ISO 8601) |
↳ joinedAt | string | Join timestamp (ISO 8601) |
↳ checkedInAt | string | Check-in timestamp from the first checked-in ticket (ISO 8601) |
↳ phoneNumber | string | Guest phone number |
hasMore | boolean | Whether more results are available for pagination |
nextCursor | string | Cursor to pass as paginationCursor to fetch the next page |
Retrieve a single guest's details on a Luma event, including approval status, registration timestamps, and contact info.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
eventId | string | Yes | Event ID the guest belongs to (starts with evt-) |
guestIdentifier | string | Yes | Guest ID (gst-...), guest key (g-...), ticket key, or the guest's email address |
| Parameter | Type | Description |
|---|
guest | object | Guest details |
↳ id | string | Guest ID |
↳ email | string | Guest email address |
↳ name | string | Guest full name |
↳ firstName | string | Guest first name |
↳ lastName | string | Guest last name |
↳ approvalStatus | string | Guest approval status (approved, session, pending_approval, invited, declined, waitlist) |
↳ registeredAt | string | Registration timestamp (ISO 8601) |
↳ invitedAt | string | Invitation timestamp (ISO 8601) |
↳ joinedAt | string | Join timestamp (ISO 8601) |
↳ checkedInAt | string | Check-in timestamp from the first checked-in ticket (ISO 8601) |
↳ phoneNumber | string | Guest phone number |
Add guests to a Luma event by email. Guests are added with Going (approved) status and receive one ticket of the default ticket type.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
eventId | string | Yes | Event ID (starts with evt-) |
guests | string | Yes | JSON 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"}] |
| Parameter | Type | Description |
|---|
added | number | Number of guests submitted to the event (added with Going/approved status) |
Send email invitations to guests for a Luma event. Unlike Add Guests (which registers guests directly), this emails an invite that recipients can accept.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
eventId | string | Yes | Event ID to invite guests to (starts with evt-) |
guests | string | Yes | JSON array of guest objects. Each guest requires an "email" field and optionally "name". Example: [{"email": "user@example.com", "name": "John Doe"}] |
message | string | No | Optional custom message included in the invite email (max 200 characters) |
| Parameter | Type | Description |
|---|
invited | number | Number of guests invited to the event |
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.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Luma API key |
eventId | string | No | Event ID the guest belongs to (starts with evt-) |
guestIdentifier | string | Yes | Guest email address or guest ID (gst-...). Values containing '@' are treated as emails; otherwise as a guest ID. |
status | string | Yes | New approval status: approved, declined, pending_approval, or waitlist |
shouldRefund | boolean | No | Refund a paid guest when moving them out of an approved state (defaults to false) |
sendEmail | boolean | No | Whether to email the guest about the status change (defaults to true) |
| Parameter | Type | Description |
|---|
status | string | The approval status applied to the guest |
guest | string | The guest identifier (email or ID) that was updated |