Luma (v2)

Quickstart

Connect to Luma with Nango and see data flow in 2 minutes. The Luma API uses API key authentication, so no user redirect is required.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Luma (v2).

Connect Luma

Go to Connections -> Add Test Connection. Enter your Luma API key, then save.

Call the Luma API

Let’s make your first request to the Luma API: fetch the user the API key belongs to. Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/v1/users/get-self" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/v1/users/get-self',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

API gotchas

Targets https://public-api.luma.com, the domain in Luma’s current API reference. The legacy luma provider targets https://api.lu.ma, which Luma keeps available for backward compatibility.

public-api.luma.com serves both the current /v1/... routes and the legacy /public/v1/... paths, so requests written for the legacy provider work here unchanged.

The Luma API requires a Luma Plus subscription.

Luma authenticates with an x-luma-api-key: API_KEY request header.

Luma rate-limits per minute: 200 requests for calendar API keys and OAuth tokens, 500 for organization API keys. Exceeding the limit returns 429 Too Many Requests and blocks for one minute; honor the Retry-After header. For more details, check Luma rate limits.

Contribute API gotchas by editing this page

Overview

900+ APIs & Integrations

Quickstart

Luma integration guides

Common scopes

API gotchas

​Quickstart

​Luma integration guides

​Common scopes

​API gotchas

Quickstart

Luma integration guides

Common scopes

API gotchas