Luma ACTION
Create Event
Create an event on the connected Luma calendar. Required datetime fields must be ISO 8601 strings and Timezone must be an IANA timezone like
America/New_York. See the documentation- Action
- Writes data
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Luma account once, then configure and run Create Event from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "luma-create-event",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
luma: { authProvisionId: "apn_xxxxxxx" },
name: "Name",
startAt: "Start At",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "luma-create-event",
"configured_props": {
"luma": { "authProvisionId": "apn_xxxxxxx" },
"name": "Name",
"startAt": "Start At"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "luma",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "luma-create-event",
arguments: {
name: "Name",
startAt: "Start At",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
name Name | string | The event name. Required |
startAt Start At | string | The event start time as an ISO 8601 datetime, for example 2026-05-15T18:00:00Z. Required |
timezone Timezone | string | The IANA timezone for the event, for example America/New_York. Required |
endAt End At | string | The event end time as an ISO 8601 datetime, for example 2026-05-15T20:00:00Z. Optional |
descriptionMd Description Markdown | string | Markdown description to convert into Luma's rich text format. Optional |
visibility Visibility | string | The event visibility. Optional |
slug Slug | string | Custom event URL slug. If aloha is available, the event URL will be https://luma.com/aloha. Optional |
meetingUrl Meeting URL | string | The online meeting URL for a virtual event. Optional |
coverUrl Cover URL | string | A cover image URL uploaded to the Luma CDN. Optional |
maxCapacity Max Capacity | integer | Maximum number of tickets or registrations before the event is sold out. Optional |
canRegisterForMultipleTickets Can Register For Multiple Tickets | boolean | Whether guests can register for multiple tickets. Optional |
showGuestList Show Guest List | boolean | Whether approved guests can see who else is attending. Optional |
remindersDisabled Reminders Disabled | boolean | Whether to disable Luma's default event reminders. Optional |
nameRequirement Name Requirement | string | How Luma should collect guest names during registration. Optional |
phoneNumberRequirement Phone Number Requirement | string | Whether guests must provide a phone number during registration. Optional |
tintColor Tint Color | string | A hex color like #bb2dc7; alpha channels are stripped by Luma. Optional |
coordinateJson Coordinate JSON | string | Optional JSON object parsed and sent as coordinate. Example: {"latitude":37.7749,"longitude":-122.4194}. Optional |
geoAddressJson Geo Address JSON | string | Optional JSON object parsed and sent as geo_address_json. Example: {"type":"google","place_id":"ChIJmQJIxlVYwokRLgeuocVOGVU","description":"Lobby entrance"}. Optional |
registrationQuestionsJson Registration Questions JSON | string | Optional JSON array parsed and sent as registration_questions. Example: [{"label":"What are you looking forward to?","required":false}]. Optional |
feedbackEmailJson Feedback Email JSON | string | Optional JSON object parsed and sent as feedback_email. Example: {"subject":"Thanks for attending!","message":"We hope you enjoyed the event."}. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- luma-create-event
- Version
- 0.0.2
- App
- Luma
- Authentication
- API key
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗