> ## Documentation Index
> Fetch the complete documentation index at: https://alhwyn.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an event

> Create a new Luma event on your calendar with luma.events.create(), passing name, dates, location, visibility, and other event parameters.

<Badge color="purple">SDK</Badge> `luma.events.create(body: EventCreateParams): Promise<Event>`

Creates a new event on your calendar.

<RequestExample>
  ```typescript Example theme={null}
  const event = await luma.events.create({
    name: "SDK test event",
    start_at: "2026-07-01T18:00:00.000Z",
    end_at: "2026-07-01T20:00:00.000Z",
    timezone: "America/Los_Angeles",
  });

  console.log("Created:", event.api_id);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "api_id": "evt-new456",
    "name": "SDK test event",
    "start_at": "2026-07-01T18:00:00.000Z",
    "end_at": "2026-07-01T20:00:00.000Z",
    "timezone": "America/Los_Angeles"
  }
  ```
</ResponseExample>

### Parameters

<ParamField path="body" type="EventCreateParams" required>
  Event fields to create. See the [official Luma API docs](https://docs.luma.com) for available fields.
</ParamField>

<Warning>
  Creates a real event on your calendar. Use a test calendar.
</Warning>

### Test it

Create a short-lived test event on a non-production calendar, then confirm it appears in `events.list()`:

```typescript theme={null}
const event = await luma.events.create({
  name: "SDK smoke test",
  start_at: "2026-12-01T18:00:00.000Z",
  end_at: "2026-12-01T19:00:00.000Z",
  timezone: "America/Los_Angeles",
});
console.log("Created:", event.api_id);
```