> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/docs/en/integrations/connector/calendar-microsoft-365.md).

# Calendar from Microsoft 365

With the PASCOM connector for Microsoft 365, you can connect calendars directly to your PASCOM phone system. Synchronization occurs server-side via a secure Microsoft OAuth connection.

<figure><img src="https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-143133e04dcc1eef847eeb3dd8c6f9f7ab5dd9ef%2Fmicrosoft-365-logo.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
**Exclusively available for AI agent Pia:**

The Microsoft 365 calendar importer is currently designed exclusively for interaction with AI agent **Pia**. Pia uses this connector to query available calendar slots in real time and automatically schedule appointments during phone calls.
{% endhint %}

### Create a Connector Profile for Microsoft 365 Calendars

Configure the connector in the PASCOM Admin Dashboard:

{% stepper %}
{% step %}

### Navigate to Connector settings

In the menu, navigate to **Settings** > **Connector**.
{% endstep %}

{% step %}

### Add a connector

Click **Add**.
{% endstep %}

{% step %}

### Select the template

In the template list, select **Microsoft 365 Calendar** and click **Select**.
{% endstep %}

{% step %}

### Enter a description

In the **Description** field, enter a meaningful name (e.g., `Microsoft 365 Calendar` or `M365 Sales Calendar`).
{% endstep %}

{% step %}

### Save the connector

Click **Save**.
{% endstep %}
{% endstepper %}

### Configure Connector Settings

Select the newly created profile in the list and click **Edit**.

#### Overview of Configuration Fields

| Field                  | Type                   | Description                                                                                                           |
| ---------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Description \***     | Input field (Required) | Name of the connector for internal identification.                                                                    |
| **Source**             | System value           | Displays the internal PASCOM connector type (`MSCALENDAR`).                                                           |
| **Authentication**     | Status & action        | Displays authorization status (e.g., `Authorized`). Click the **click here** link to authorize the Microsoft account. |
| **Calendar**           | Action link            | Click **Select calendars** to open the selection dialog for all available Microsoft 365 calendars.                    |
| **Selected Calendars** | Overview               | Lists all calendars currently activated for data synchronization.                                                     |

### Authenticate with Your Microsoft Account

To allow PASCOM to access calendar data, a one-time OAuth authorization is required:

{% stepper %}
{% step %}

### Start authorization

In the **Authentication** section, click the blue **click here** link.
{% endstep %}

{% step %}

### Sign in to Microsoft

You are automatically redirected to the Microsoft login dialog.

Log in with an authorized Microsoft 365 account (e.g., an administrator or service account).

<figure><img src="https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-c76cfbdaaa54438803bf6e28c08b0da39b8b0924%2Fmicrosoft-auth.en.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Confirm permissions

Confirm the requested permissions to grant the PASCOM phone system read and write access to your calendars.
{% endstep %}

{% step %}

### Return to PASCOM

After successful authorization, you return automatically to the PASCOM dashboard. The status changes to **Authorized**.
{% endstep %}
{% endstepper %}

### Select Calendars for Synchronization

After successful authorization, define which calendars the connector should synchronize:

{% stepper %}
{% step %}

### Open calendar selection

Next to the **Calendar** field, click the blue **Select calendars** link.
{% endstep %}

{% step %}

### Load available calendars

The system queries the available calendars from your Microsoft 365 account and displays them for selection.
{% endstep %}

{% step %}

### Select relevant calendars

Select all calendars that are relevant to you:

* **Company & Team Calendars**: Central calendars for teams, pools, or general customer service (e.g., `Sales Appointments`, `Support Consultations`).
* **Personal Work Calendars**: User-specific calendars for individual employees or consultants (e.g., `John Doe - Calendar`).
* **Vacation & Absence Calendars**: Calendars tracking planned absences (e.g., `Vacation`, `Training`, `My Vacation`).
* **Closing Days, Holidays & Non-Working Days**: Calendars containing statutory public holidays, company shutdowns, or scheduled non-working days.
  {% endstep %}

{% step %}

### Confirm your selection

Confirm your selection.
{% endstep %}

{% step %}

### Review selected calendars

The activated calendars appear under **Selected Calendars**.
{% endstep %}

{% step %}

### Save the configuration

Finally, click **Save**.
{% endstep %}
{% endstepper %}

### Next Steps: Set Up Appointment Scheduling with Pia

All calendars listed under **Selected Calendars** are now immediately available to your AI agent **Pia**.

For detailed instructions on configuring appointment parameters in your prompt, refer to [Use Pia Actions with Inline Tools](https://docs.pascom.net/docs/en/setup/acd/ai-agents-pia-setup/pia-actions-inlinetools.md)


---

# 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.pascom.net/docs/en/integrations/connector/calendar-microsoft-365.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.
