Luma Integration Guide

Last updated Nov 19th, 2026

Overview

Connect your Luma calendar to bring event registrations and attendance into Common Room. Common Room turns sign-ups and check-ins into signals tied to people and accounts in your room, so you can:

  • See who registered for and attended each event on their profile
  • Tell who signed up apart from who showed up
  • Build segments and scores from event registration and attendance
  • Start workflows when someone registers or attends

Availability

The Luma integration is included on all plans.

Requirements

  • A Luma Plus subscription. Luma's API is only available on Luma Plus.
  • Admin access to the Luma calendar you want to connect, so you can create an API key.
  • Owner or admin access in Common Room.

What we import

Luma dataIn Common Room
Guests who are going, pending approval or waitlisted
A Registered activity on the contact
Guests who checked in (in person) or joined online (virtual)
A separate Attended activity on the contact
Event name, date and link
Shown on each activity
Answers to Luma's standard registration questions (company, job title, website, GitHub, LinkedIn, X)
Shown on the Registered activity and used to match the right contact and company

If a registrant isn't in Common Room yet, we create a contact for them. The first time you connect, we import the full registration and attendance history for the calendar.

Not imported:

  • Invited guests who never registered, and declined guests
  • Calendar subscribers who never registered for an event
  • Events where your calendar is only a co-host. Luma doesn't share guest lists for events managed by another calendar.
  • Answers to custom free-text questions (for example, a "City" or "LinkedIn Profile URL" text field)
  • Ticket, payment and coupon data

Setup

Step 1: Create an API key in Luma

  1. Go to luma.com/calendar/manage/api-keys and select the calendar you want to connect.
  2. Generate an API key.
  3. Copy the key and store it securely.

Step 2: Connect Luma in Common Room

  1. In Common Room, go to Settings → Signals and integrations.
  2. Find the Luma tile and click Connect.
  3. Paste your API key and click Verify API key.
  4. Review what will be imported, then click Start import.

You'll land on the Luma settings page while the first import runs. Larger calendars can take a while to import.

Step 3: Check the connection

The Luma settings page shows your connected calendar, its status, when and by whom it was connected, and when it last synced. Click View contact summary to see the contacts that came from Luma.

Technical details

Import history and sync frequency

  • New registrations come in shortly after they happen.
  • A daily import catches anything that was missed and picks up attendance from recent events.
  • There are no sync settings to configure, and you don't need to set anything up per event.
  • If a guest's status changes (for example, they decline), the Registered activity is removed. If a check-in is undone, the Attended activity is removed.
  • Registrations and attendance for canceled events stay in Common Room.

Using Luma data

On a contact's profile

Open a contact and go to the Activity tab. Luma activities show the event name, calendar and date. Registered activities also show the guest's answers to standard registration questions, such as company, job title and website.

Filter contacts by event activity

On the Contacts page, click Add filter, then choose Luma:

  • # of Event registrations: how many events a contact registered for in a time range
  • # of Event attends: how many events a contact attended in a time range
  • Event Name: contacts who registered for or attended a specific event

Set an At least / At most count and a time range (for example, Last 12 weeks).

Build a segment of registrants or attendees

After filtering, click Create segment and choose Create a contact segment or Create a contact team segment. New registrants or attendees who match the filters are added on your segment's normal auto-add schedule.

Scores and workflows

You can use Luma registration and attendance in scores and workflows like any other signal. For example, score attendees higher than registrants, or start a workflow when someone attends an event.

Manage the connection

Reconnect

If your API key is revoked or rotated, Common Room shows that Luma needs to be reconnected. Click Reconnect, then paste a new API key for the same calendar. You don't need to disconnect first.

Switch calendars

You can connect one Luma calendar per room. To connect a different calendar, disconnect the current one, then connect again with the other calendar's API key. If you try to reconnect with a key from a different calendar, you'll see an error asking you to disconnect first.

Disconnect

On the Luma settings page, click Disconnect and confirm. Common Room removes its webhook from your Luma calendar and deletes the stored API key. Activities that were already imported stay in Common Room.

FAQ

Do I need Luma Plus?

Yes. Luma's API, which the integration uses, is only available on Luma Plus.

Can I connect more than one Luma calendar?

Not yet. Each room can connect one calendar. Connect the calendar that hosts most of your events.

Why don't I see guests from events we co-host?

Luma only shares guest lists with the calendar that manages the event. Events where your calendar is a co-host aren't available through the API.

Why are fewer contacts imported than guests in Luma?

We import only guests who registered (going, pending approval or waitlisted). Invited and declined guests, and calendar subscribers who never registered, aren't imported. Contacts who registered with more than one email may also be merged into one profile.

Why isn't location or LinkedIn showing for some guests?

We only read Luma's standard registration questions. Answers to custom free-text questions, such as City or "LinkedIn Profile URL", aren't imported yet. For best results, use Luma's standard Company, Job title and social profile questions.

How is Registered different from Attended?

Registered means the guest signed up and is going, pending approval or waitlisted. Attended means they checked in at an in-person event or joined a virtual event online.

Support chat

Chatbot @ now

How else can I help with Luma?

We use tracking to better understand our visitors. Read more.