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

# Calendar Event QR Code

> Create a QR code that adds an event to a calendar.

## What it's for

A Calendar Event QR code prompts the scanning device to save an event straight into its calendar app — with the name, time, location, and description already filled in. It's a **Quick Code** — a direct-action QR with no landing page. In the app, the tile for it reads "Prompt the scanner to save an event to their calendar," and the tile is labeled **Event Calendar** (the underlying category name is "Calendar Event" — both refer to the same type).

<Note>
  Calendar Event is **Static only** — there's no Dynamic option for this type. Once published, the encoded event can't be edited or tracked; to change it, create a new QR code.
</Note>

## Create a Calendar Event QR code

<Steps>
  <Step title="Open Create QR Code and choose Quick Code">
    From the sidebar, go to **QR Codes**, then click **Create QR Code** (or navigate to `/qr/create`). Click the **Quick Code** card.
  </Step>

  <Step title="Pick Event Calendar">
    On the **Quick Code** type grid, click **Configure** under **Event Calendar**, in the **Static Only** section. This opens the form at `/qr/quick/calendar`.
  </Step>

  <Step title="Enter the event details">
    Fill in the fields:

    * **Event name** — required.
    * **Start date & time** — required.
    * **End date & time** — optional; if set, it must be on or after the start date, or an inline error blocks publishing.
    * **Location** (placeholder "1 Infinite Loop, Cupertino, CA") — optional.
    * **Description** — optional, multi-line.
    * **Time zone** — optional, defaults to "None (device default)" (the scanner's own device time zone).

    <Frame caption="The Event Calendar Quick Code form with an event name, start/end time, location, and description entered">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/calendar-event/calendar-quick-code-form.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=c22f076b2813dc34e172b7f70dc3f4e3" alt="Event Calendar Quick Code form with an event name, start and end date/time, location, and description filled in, plus a live QR preview on the right" width="1280" height="728" data-path="images/v2/qr-codes/create/calendar-event/calendar-quick-code-form.png" />
    </Frame>
  </Step>

  <Step title="Publish">
    Click **Publish**. A panel opens to confirm or rename the QR code (it defaults to the event name), assign a folder or tags, and adjust QR design before confirming. Once published, you can revisit design (colors, frame) from **Edit Design** on the confirmation screen.
  </Step>
</Steps>

## Creating one via the API

To create a Calendar Event QR code through the API rather than the UI, use category ID `12` (labeled **Calendar Event**, `allowed_qr_types: "st"` — only `"st"` is valid for `qr_type`), with an `info` payload shaped like:

```json theme={null}
{
  "type": "calendar",
  "data": {
    "name": "Product Launch Webinar",
    "startDate": "2026-09-10T15:00",
    "endDate": "2026-09-10T16:00",
    "location": "Online — Zoom",
    "description": "Join us for the launch of our new product line.",
    "timeZone": "Asia/Kolkata"
  }
}
```

Only `name` and `startDate` are required by the backend schema; both date fields are free-form strings with no enforced format — the dashboard form sends its `datetime-local` input's raw value (`YYYY-MM-DDTHH:mm`) as shown above.

<Note>
  Category ID `12` ("Calendar Event") is distinct from category ID `20` ("Event"), which is a different, page-builder category — don't confuse the two.
</Note>

See [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) for the full request schema.

<Note>
  The [Category List](/v1/api-reference/references/category-list) reference table doesn't currently list Calendar Event (or the other Quick Code–only categories on this page) — the ID above was confirmed directly against the live `/qr/category/` endpoint.
</Note>

## Related

* [Event QR Code](/qr-codes/create/event) — the different, page-builder "Event" category (schedule, venue, tickets) — don't confuse the two.
* [Creating your first QR code](/getting-started/first-qr-code) — a full walkthrough of the Quick Code flow this type belongs to.
* [Folders, tags & bulk operations](/qr-codes/manage/folders-tags-bulk-operations) — organize the QR code after publishing it.