# Connect Microsoft Planner Premium
This guide walks you through connecting Microsoft Planner Premium (also called **Planner and Project Plan 3**) to the app. This feature is currently in **Early Access**.
### Why is Planner Premium Setup Different?
Even though Planner Premium looks similar to regular MS Planner, it's built on a different platform (Microsoft Dataverse) with its own API. This means setup requires additional configuration steps.
***
### 1. Connect Microsoft Planner First
Before setting up Planner Premium, make sure **Microsoft Planner** is already connected on the same connection setup page. This is a prerequisite.
***
### 2. Discover Your Dataverse Environment
Click **Setup Required** under the Microsoft Planner Premium section, then click **Discover Environments**. The app will automatically scan your Dataverse environments.
Alternatively, click **Enter URL manually instead** to provide the Dataverse URL yourself (advanced).
***
### 3. Select Your Environment
You'll see a dropdown with your Dataverse environments. In most setups, Planner Premium works with the default environment marked as **(default)**.
Keep the default if you're unsure, or switch to the environment that works with your Planner Premium if you know it.
***
### 4. Validate & Connect
Click **Validate & Connect**. The app will check if the selected Dataverse environment is connected to Planner Premium.
* If successful, you'll see **Read from Premium plans** with a green checkmark — the app now has access to reading your premium data.
* If you see an error, the selected Dataverse environment is incorrect and not connected to your Planner Premium. Try a different environment.
***
### 5. Set Up Write Permissions
The next step is enabling write access to Premium plans. Your user needs two permissions:
* `msdyn_operationset`
* `msdyn_operationsetdetail`
These allow the app to create and update tasks in Planner Premium on your behalf.
You can either:
* **Use Autoconfigure** (recommended) — see step 6 below
* **Set up manually** — follow the [manual setup guide](/docs/basics/planner-premium-manual-setup.md)
***
### 6. Autoconfigure Roles (Admin)
If you're an admin, expand the **Autoconfigure** section:
* **Create "MS Planner Jira Sync" Role** — creates a new security role with the two required permissions, plus an application user that has this role and can assign it to others
* **Assign Role to Me** — makes the app user assign the role to your account so the app can operate on your behalf
Once complete, you'll see green checkmarks for both **Read from Premium plans** and **Write to Premium plans** — setup is finished!
***
### Not an Admin?
If you're not an admin, we have an experimental feature:
1. Click **Generate Admin Setup Link**
2. Send the link to your admin
When your admin clicks the link, the same setup happens under the hood — a new role is created with the two required permissions, plus an application user with this role.
After your admin completes the setup, you'll be able to click **Assign Role to Me** from the interface to get the permissions you need.
***
✅ Once both read and write are configured, you're ready to sync with Planner Premium plans!
---
# 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://msplannertojira.gitbook.io/docs/basics/connect-microsoft-planner-premium-eap.md?ask=
```
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.