> For the complete documentation index, see [llms.txt](https://docs.appfarm.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appfarm.io/library/action-nodes/create-calendar-event.md).

# Create calendar event

The **Create Calendar Event** action node creates a calendar event. The user can download it as an `.ics` file, store it as a file in a data source, or open it in Google Calendar. It is available in apps.

{% hint style="info" %}
Showroom: [Create calendar event example](https://showroom.appfarm.app/action-nodes/create-calendar-event), with its setup in Appfarm Create ([register](https://showroom.appfarm.app/sign-up) for access).
{% endhint %}

## Usage

Use it to let users add a booking, a meeting or a deadline to their own calendar. An `.ics` file opens in most calendar apps, such as Outlook, Apple Calendar and Google Calendar.

Start and end times are written to the file in UTC, so the event shows at the right local time in the user's calendar.

## Properties

### Event settings

| Property                 | Description                                                                                                                                                                                                                                                                  |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Event ID**             | A unique ID for the event, for example the ID of a booking object. If a user downloads the event again with the same ID, their calendar updates the existing event instead of adding a new one. If empty, a new ID is made each time, so every download becomes a new event. |
| **Start**                | When the event starts. Bind to a Datetime property.                                                                                                                                                                                                                          |
| **End**                  | When the event ends. Bind to a Datetime property.                                                                                                                                                                                                                            |
| **Summary**              | The event title.                                                                                                                                                                                                                                                             |
| **Description**          | The event text.                                                                                                                                                                                                                                                              |
| **Location**             | Where the event takes place.                                                                                                                                                                                                                                                 |
| **Google Calendar link** | Open a prefilled Google Calendar event in a new browser tab instead of creating a file. The **File options** are hidden when this is selected.                                                                                                                               |

### File options

| Property             | Description                                                                                                                                                                                                         |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **File name**        | The file name, without the extension. `.ics` is added. If empty, the file is called `event.ics`.                                                                                                                    |
| **File target**      | **Download** (default) downloads the file in the browser. **Put in Data Source** stores it as a new file object.                                                                                                    |
| **Data source**      | *Visible when **File target** is **Put in Data Source**.* A data source of a [file object class](https://docs.appfarm.io/reference/data-model/object-classes.md). A data source with cardinality one must be empty. |
| **Values on create** | *Visible when a **Data source** is selected.* Values to set on the new file object, for example a reference to the booking.                                                                                         |

## Example

On a booking confirmation view, add a button **Add to calendar**. In its **On Click** action, add **Create Calendar Event** with:

* **Event ID**: `Booking (selected).ID`
* **Start** and **End**: the booking's start and end times
* **Summary**: `Booking (selected).Title`
* **Location**: `Booking (selected).Address`
* **File name**: `booking`

The user gets `booking.ics`. If the booking changes and they download it again, their calendar updates the event.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.appfarm.io/library/action-nodes/create-calendar-event.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
