---
title: "Add Event"
method: POST
path: "/v1/calendars/events/add"
tags: ["Calendars"]
---

# Add Event

`POST /v1/calendars/events/add`

Add or submit an existing event (on Luma or on an external platform) to the Luma calendar. By default, events added by a calendar manager are approved immediately. Use `submission_mode: "pending"` to keep the submission pending.

On calendars with `require-manage-access`, submitting a Luma event you manage can also grant the target calendar manage access once the submission is approved.

## Request body

- union
  - object
    - `platform` 'external', required
    - `submission_mode` 'auto' | 'pending' — `auto` approves the event immediately. `pending` keeps the event pending for calendar admin approval.
    - `url` string, required
    - `name` string, required
    - `start_at` string, date-time, required — ISO 8601 Datetime. For example, 2022-10-19T03:27:13.673Z
    - `duration_interval` string, required
    - `timezone` string, required — IANA Timezone, e.g. America/New_York. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
    - `geo_address_json` union
      - object
        - `type` 'manual', required
        - `address` string, required
      - object
        - `type` 'google', required
        - `place_id` string, required
        - `description` string, nullable
    - `host` string, nullable
    - `geo_longitude` number, nullable
    - `geo_latitude` number, nullable
    - `coordinate` object, nullable
      - `longitude` number, required
      - `latitude` number, required
  - object
    - `platform` 'luma', required
    - `submission_mode` 'auto' | 'pending' — `auto` approves the event immediately. `pending` keeps the event pending for calendar admin approval.
    - `event_id` string — Event ID, this usually starts with evt-
    - `event_api_id` string — Use `event_id` instead.

## Response `200`

Successful response.

- object
  - `id` string, required
  - `status` 'approved' | 'pending', required

---

[API](https://skmtc.net/luma/apis/luma-api.md) · [All operations](https://skmtc.net/luma/apis/luma-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luma/luma-api/revisions/12835be09062/schema)