Luma

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

With Luma integrated into AACFlow, 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 AACFlow 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 AACFlow workflows.

Nutzungsanleitung

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.

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Luma API key
`eventId`	string	Ja	Event ID (starts with evt-)

Ausgabe

Parameter	Typ	Beschreibung
`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

`luma_create_event`

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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Luma API key
`name`	string	Ja	Event name/title
`startAt`	string	Ja	Event start time in ISO 8601 format (e.g., 2025-03-15T18:00:00Z)
`timezone`	string	Ja	IANA timezone (e.g., America/New_York, Europe/London)
`endAt`	string	Nein	Event end time in ISO 8601 format (e.g., 2025-03-15T20:00:00Z)
`durationInterval`	string	Nein	Event duration as ISO 8601 interval (e.g., PT2H for 2 hours, PT30M for 30 minutes). Used if endAt is not provided.
`descriptionMd`	string	Nein	Event description in Markdown format
`meetingUrl`	string	Nein	Virtual meeting URL for online events (e.g., Zoom, Google Meet link)
`visibility`	string	Nein	Event visibility: public, members-only, or private (defaults to public)
`coverUrl`	string	Nein	Cover image URL (must be a Luma CDN URL from images.lumacdn.com)

Ausgabe

Parameter	Typ	Beschreibung
`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

`luma_update_event`

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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Luma API key
`eventId`	string	Ja	Event ID to update (starts with evt-)
`name`	string	Nein	New event name/title
`startAt`	string	Nein	New start time in ISO 8601 format (e.g., 2025-03-15T18:00:00Z)
`timezone`	string	Nein	New IANA timezone (e.g., America/New_York, Europe/London)
`endAt`	string	Nein	New end time in ISO 8601 format (e.g., 2025-03-15T20:00:00Z)
`durationInterval`	string	Nein	New duration as ISO 8601 interval (e.g., PT2H for 2 hours). Used if endAt is not provided.
`descriptionMd`	string	Nein	New event description in Markdown format
`meetingUrl`	string	Nein	New virtual meeting URL (e.g., Zoom, Google Meet link)
`visibility`	string	Nein	New visibility: public, members-only, or private
`coverUrl`	string	Nein	New cover image URL (must be a Luma CDN URL from images.lumacdn.com)

Ausgabe

Parameter	Typ	Beschreibung
`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

`luma_list_events`

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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Luma API key
`after`	string	Nein	Return events after this ISO 8601 datetime (e.g., 2025-01-01T00:00:00Z)
`before`	string	Nein	Return events before this ISO 8601 datetime (e.g., 2025-12-31T23:59:59Z)
`paginationLimit`	number	Nein	Maximum number of events to return per page
`paginationCursor`	string	Nein	Pagination cursor from a previous response (next_cursor) to fetch the next page of results
`sortColumn`	string	Nein	Column to sort by (only start_at is supported)
`sortDirection`	string	Nein	Sort direction: asc, desc, asc nulls last, or desc nulls last

Ausgabe

Parameter	Typ	Beschreibung
`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

`luma_get_guests`

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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Luma API key
`eventId`	string	Ja	Event ID (starts with evt-)
`approvalStatus`	string	Nein	Filter by approval status: approved, session, pending_approval, invited, declined, or waitlist
`paginationLimit`	number	Nein	Maximum number of guests to return per page
`paginationCursor`	string	Nein	Pagination cursor from a previous response (next_cursor) to fetch the next page of results
`sortColumn`	string	Nein	Column to sort by: name, email, created_at, registered_at, or checked_in_at
`sortDirection`	string	Nein	Sort direction: asc, desc, asc nulls last, or desc nulls last

Ausgabe

Parameter	Typ	Beschreibung
`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 (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

`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.

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`apiKey`	string	Ja	Luma API key
`eventId`	string	Ja	Event ID (starts with evt-)
`guests`	string	Ja	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"}]

Ausgabe

Parameter	Typ	Beschreibung
`guests`	array	List of added guests with their assigned status and ticket info
↳ `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 (ISO 8601)
↳ `phoneNumber`	string	Guest phone number

On this page