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

# Microsoft Planner Provider

> Microsoft Planner Provider to create task in planner.

## Authentication

This provider requires authentication.

* **tenant\_id**: Planner Tenant ID (required: True, sensitive: True)
* **client\_id**: Planner Client ID (required: True, sensitive: True)
* **client\_secret**: Planner Client Secret (required: True, sensitive: True)

## In workflows

This provider can be used in workflows.

As "action" to make changes or update data, example:

```yaml theme={null}
actions:
    - name: Query planner
      provider: planner
      config: "{{ provider.my_provider_name }}"
      with:
        plan_id: {value}  
        title: {value}  
        bucket_id: {value}  
```

Check the following workflow example:

* [planner\_basic.yml](https://github.com/keephq/keep/blob/main/examples/workflows/planner_basic.yml)

## Connecting with the Provider

To connect to Microsoft Planner, follow below steps:

1. Log in to your [Azure](https://azure.microsoft.com/) account.
2. Register an application [here](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/CreateApplicationBlade/isMSAApp~/false).
3. After successfully registering the application, go to the **API permissions** page and add the below permissions:
   * `Tasks.Read.All`
   * `Tasks.ReadWrite.All`
4. Go to **Overview** page and note the `Application (client) ID` and `Directory (tenant) ID`.
5. Go to **Certificates & secrets** page, create a new client secret and note the client secret value.
6. Add the client id, client secret and tenant id to the `authentication` section in the Microsoft Planner Provider configuration.

## Notes

* This provider allows you to interact with Microsoft Planner Provider to create tasks.

## Useful Links

* [Microsoft Planner Provider Documentation](https://learn.microsoft.com/en-us/graph/api/planner-post-tasks?view=graph-rest-1.0\&tabs=http)
* [Create an Azure Active Directory app](https://learn.microsoft.com/en-us/graph/toolkit/get-started/add-aad-app-registration)