# Google & Outlook Calendar

{% hint style="success" %}
**Audience:** Admins, Developers, Solution Architects

**Purpose:** Explains what the calendar integration is, why teams use it, and how Google and Outlook calendars connect with <code class="expression">space.vars.Kizen\_company\_name</code> to support scheduling events.&#x20;
{% endhint %}

## Overview

Google and Outlook Calendar Integrations allow <code class="expression">space.vars.Kizen\_company\_name</code> to create calendar events in an external calendar based on supported `date` or `datetime` fields. When an integration is enabled, these fields can generate calendar events that are associated with <code class="expression">space.vars.activities</code> or <code class="expression">space.vars.entities</code>, syncing to Google Calendar or Outlook.

{% hint style="warning" %}
**Important**: These integrations do **not** automatically sync calendars or import events from Google or Outlook back into <code class="expression">space.vars.Kizen\_company\_name</code>. Changes made directly in your external calendar are not reflected in <code class="expression">space.vars.Kizen\_company\_name</code> unless the <code class="expression">space.vars.activity</code> is created or updated within <code class="expression">space.vars.Kizen\_company\_name</code> itself.
{% endhint %}

***

## How Does the Calendar Integration Work?

Calendar integrations are enabled through the App Marketplace. Once enabled:

* A calendar button appears next to the supported date fields in <code class="expression">space.vars.Kizen\_company\_name</code>
* Selecting this button lets users create a calendar event directly in Google Calendar or Outlook
* The event opens with details pre-filled, including a link back to the <code class="expression">space.vars.entities</code> the user was viewing

### Google vs Outlook Behavior

Google and Outlook calendar integrations work the same from a user perspective, with one technical difference:

* Google Calendar: Opens a new browser tab and passes event details using a URL
* Outlook Calendar: Downloads an `.ical` file with the event details, which you can open in Outlook to review and save the event to your calendar

In both cases, users must review the event and save it in their calendar.

### Account Behavior and Common Scenarios

Calendar events are always created in the calendar account currently signed into your browser.

This means:

* If you are already signed into Google or Microsoft, you may not see a login prompt when creating an event.
* If you are signed into a personal account, events will be created in that account, even if your Integrated Inbox is connected to a different email address.

{% hint style="warning" %}
**Caution:** Calendar Integration does not automatically use the same account as Integrated Inbox. Always confirm which Google or Microsoft account is active in your browser before creating events.
{% endhint %}

#### What to Expect in Different Scenarios

**New Users**

* You must enable the integration in the App Marketplace before use
* You will be redirected to your calendar provider the first time you create an event

**Users with Multiple Kizen Accounts**

* Authentication may feel faster if you are already signed into your calendar provider
* Events are still created in the currently active Google or Outlook account

**Organizations using SSO**

* Authentication may feel more seamless
* Behavior remains the same: events are created in the active calendar account

***

## What’s Next

To get started with calendar integration, see the [Enabling the Calendar Integration](/docs/integrations-and-plugins/integrations/google-and-outlook-calendar/enabling-calendar-integration.md) topic. You can also learn about [Creating Calendar Events](/docs/integrations-and-plugins/integrations/google-and-outlook-calendar/creating-calendar-events-from-contacts.md).

<details>

<summary>Related Topics</summary>

* [Enabling the Calendar Integration](/docs/integrations-and-plugins/integrations/google-and-outlook-calendar/enabling-calendar-integration.md)
* [Creating Calendar Events](/docs/integrations-and-plugins/integrations/google-and-outlook-calendar/creating-calendar-events-from-contacts.md)

</details>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.kizen.com/docs/integrations-and-plugins/integrations/google-and-outlook-calendar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.