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

# Setup

> Connect to your Monday App for OAuth.

Refold offers both **Key Based** and **OAuth 2.0** integration for Monday. In this guide, we will look at the OAuth App setup process.

To setup your Monday app in Refold for OAuth, you will need the following credentials from your Monday Developer account:

* Client ID
* Client Secret
* Scopes

### Pre-requisites

1. Monday Developer account. You can create one [here](https://auth.monday.com/users/sign_up_new?developer=true).

### Required Settings

* **Mandatory Scopes**

1. me:read
2. webhooks:write

<Info>If you haven't already created an app in Monday, you'd need to create one.</Info>

### Creating an app in Monday

To create a Monday app and acquire the above mentioned credentials, please follow the steps mentioned below:

1. Log in to your [Monday Developer account](https://auth.monday.com/auth/login_monday?).
2. Click on the `Profile` icon in the top right and select `Developers` button.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Monday/monday_navigation.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=3c64458441a7f256263cd00b9c1771e9" alt="Navigation for App setup" data-path="images/Monday/monday_navigation.png" />

3. Click on `Create app` button under `My Apps`.
4. Enter the `Name` for your application under **Basic Information** and click `Save App`.
5. Go to your [`Apps catalog`](https://app.gocobalt.io/apps) in **Refold** > Search for `Monday` > `Settings` > `Use your credentials` > `Callback Url` > Copy it.
6. Go to `OAuth` in the app in the side menu > Go to the `Redirect URLs` tab > Paste the Callback Url > Click on `Save Scopes`.
7. Select the **mandatory scopes** in the `Scopes` tab under **OAuth**, as provided in your Refold Monday settings page and click on the `Save Scopes` button.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Monday/monday_config.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=7eb9339e0eebde18925915da4bd49350" alt="Setting up Monday Developer app" data-path="images/Monday/monday_config.png" />

8. Go to the **Basic Information** section and copy the **Client ID** and **Client Secret** from the App Credentials section.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Monday/monday_credentials.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=0a075e64e10bc55215c33fc1d544c139" alt="Getting Credentials" data-path="images/Monday/monday_credentials.png" />

#### Configuring credentials in Refold

App settings page lets you configure the authentication settings for an `OAuth 2.0` based application. For your customers to provide you authorization to access their data,
they would first need to install your application. This page lets you set up your application credentials.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Monday/monday_cobalt.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=8480bf75ec7de06a6bd3951fb6874662" alt="Setting up application client credentials" data-path="images/Monday/monday_cobalt.png" />

Provide the acquired Client ID and Client Secret under Settings of the app and save it.

#### Configuring Scopes

Refold lets you configure what permissions to ask from your users while they install your application. The scopes can be added or removed from the App settings page, under `Permissions & Scopes`
section.

For some applications Refold sets **mandatory scopes** which cannot be removed. Additional scopes can be selected from the drop down. Refold also has the provision to add any
custom scopes supported by the respective platform.

<img height="200" src="https://mintcdn.com/cobalt-55/0IGKzTphHY-auv_h/images/Monday/monday_scopes.png?fit=max&auto=format&n=0IGKzTphHY-auv_h&q=85&s=5ce74a1c65f652772cb56db5bac80f24" alt="OAuth Scopes" data-path="images/Monday/monday_scopes.png" />

Once the scopes has been added to the application in Refold, go to your [Monday Developer account](https://auth.monday.com/auth/login_monday?) and update the scopes as added on Refold.

Select the OAuth App created for Refold > Click on `Scopes` tab under **OAuth** > Add the scopes as added in Refold > Click on `Save Scopes`.

<Warning>
  If you are facing scopes missing or invalid scope error. Make sure you are not passing any custom scope not supported by the platform. And, the scopes selected here are
  identical to the ones selected in the platform.
</Warning>

#### Actions and triggers

Once the above setup is completed, you can create orchestrations of your use-cases using Monday actions and triggers. Following are the set of Monday actions and triggers
supported by Refold.

<Tabs>
  <Tab title="Actions">
    <AccordionGroup>
      <Accordion title="Board">
        1. **Create Board** - Create a board in Monday.
        2. **Update Board** - Update a board in Monday.
        3. **Delete Board** - Delete a board in Monday.
        4. **List Boards** - List all boards in Monday.
      </Accordion>

      <Accordion title="Column">
        5. **List Columns** - List all columns of a board in Monday.
        6. **Create Column** - Create a column in board in Monday.
        7. **Change Column Title** - Change the title of column in Monday.
        8. **Delete Column** - Delete column of a board in Monday.
      </Accordion>

      <Accordion title="Documents">
        9. **List Documents** - List all documents in Monday.
        10. **Create Doc** - Create a document in Document column in Monday.
      </Accordion>

      <Accordion title="Group">
        11. **Create Group** - Create a group in Monday.
        12. **Update Group** - Update a group in Monday.
        13. **Delete Group** - Delete a group in Monday.
        14. **List Groups** - List all groups in Monday.
      </Accordion>

      <Accordion title="Item">
        15. **Create Item** - Create an item in Monday.
        16. **Update Item** - Update an item in Monday.
        17. **Delete Item** - Delete an item in Monday.
        18. **List Item** - List all items in Monday.
      </Accordion>

      <Accordion title="Sub-item">
        19. **Create Subitem** - Create a subitem in Monday.
        20. **Update Subitem** - Update a subitem in Monday.
        21. **Delete Subitem** - Delete Subitem in Monday.
        22. **List Subitem** - List all subitems in Monday.
      </Accordion>

      <Accordion title="Teams">
        23. **List Teams** - List all teams in Monday.
        24. **Create Team** - Create a team in Monday.
        25. **Add Teams To Board** - Add teams to a board in Monday.
        26. **Delete Team** - Delete a team in Monday.
      </Accordion>

      <Accordion title="Others">
        27. **HTTP Request** - Make HTTP API calls to any Monday documented REST APIs.
        28. **Custom Query** - Run a custom query in Monday.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Triggers">
    1. **Item Created** - Triggers when an item is createdd on Monday.
    2. **Subitem Created** - Triggers when a subitem is created on Monday.
    3. **Column Value Updated** - Triggers when a column value is updated on Monday.
    4. **Status Column Value Updated** - Triggers when a status column value is updated on Monday.
    5. **Subitem Column Value Updated** - Triggers when a subitem column value is updated on Monday.
    6. **Specific Column Value Updated** - Triggers when a specific column value is updated on Monday.
  </Tab>
</Tabs>