Luma

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

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`eventId`	string	Yes	No description

Output

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

`luma_create_event`

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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`name`	string	Yes	No description
`startAt`	string	Yes	No description
`timezone`	string	Yes	No description
`endAt`	string	No	No description
`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	No description
`meetingUrl`	string	No	No description
`visibility`	string	No	No description
`coverUrl`	string	No	No description

Output

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

`luma_update_event`

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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`eventId`	string	Yes	No description
`name`	string	No	No description
`startAt`	string	No	No description
`timezone`	string	No	No description
`endAt`	string	No	No description
`durationInterval`	string	No	New duration as ISO 8601 interval (e.g., PT2H for 2 hours). Used if endAt is not provided.
`descriptionMd`	string	No	No description
`meetingUrl`	string	No	No description
`visibility`	string	No	No description
`coverUrl`	string	No	No description

Output

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

`luma_list_events`

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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`after`	string	No	No description
`before`	string	No	No description
`paginationLimit`	number	No	No description
`paginationCursor`	string	No	Pagination cursor from a previous response (next_cursor) to fetch the next page of results
`sortColumn`	string	No	No description
`sortDirection`	string	No	No description

Output

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

`luma_get_guests`

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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`eventId`	string	Yes	No description
`approvalStatus`	string	No	Filter by approval status: approved, session, pending_approval, invited, declined, or waitlist
`paginationLimit`	number	No	No description
`paginationCursor`	string	No	Pagination cursor from a previous response (next_cursor) to fetch the next page of results
`sortColumn`	string	No	No description
`sortDirection`	string	No	No description

Output

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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`eventId`	string	Yes	No description
`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"}]

Output

Parameter	Type	Description
`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