> ## 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 Asana app for OAuth.

To setup your Asana app in Refold for OAuth, you will need the following credentials from your [Asana Developer Console](https://app.asana.com/0/developer-console):

* Client ID
* Client Secret
* Scopes

### Pre-requisites

1. Asana Developer Console. You can create one [here](https://asana.com/create-account).

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

### Creating an app in Asana

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

1. Log in to your [Asana Developer Console](https://app.asana.com/0/developer-console).
2. Under `My apps`, click on the `Create new app` button.

<img height="200" src="https://mintcdn.com/cobalt-55/USIhqTKu3QZXm8QM/images/Asana/asana_navigation.png?fit=max&auto=format&n=USIhqTKu3QZXm8QM&q=85&s=c4cbef1c47e2a122e4e9c6b0fed388a0" alt="Navigation for App setup" data-path="images/Asana/asana_navigation.png" />

3. Enter the `App name` for your application, select description for app and click on `Create app`.
4. Go to your [`Apps catalog`](https://app.gocobalt.io/apps) in **Refold** > Search for `Asana` > `Settings` > `Use your credentials` > `Callback Url` > Copy it.
5. In the OAuth app, navigate to `OAuth` under **Configure** in the side menu > Click on `+ Add redirect URL` > Paste the Callback Url > Click on `Add`.
6. Click on `Manage distribution` in the side menu and choose a distribution method based on your requirements.

<img height="200" src="https://mintcdn.com/cobalt-55/USIhqTKu3QZXm8QM/images/Asana/asana_config.png?fit=max&auto=format&n=USIhqTKu3QZXm8QM&q=85&s=aebe93e7351eceb9cdd33a3d75935317" alt="Setting up Asana Developer app" data-path="images/Asana/asana_config.png" />

<Info>
  Learn more about app distribution [here](https://developers.asana.com/docs/share-your-app).
</Info>

7. Navigate to `Basic information` and copy the **Client ID** and **Client Secret**.

<img height="200" src="https://mintcdn.com/cobalt-55/USIhqTKu3QZXm8QM/images/Asana/asana_credentials.png?fit=max&auto=format&n=USIhqTKu3QZXm8QM&q=85&s=9e732e1ab6a47b6d1ac9f74f67b214d2" alt="Getting Credentials" data-path="images/Asana/asana_credentials.png" />

#### Configuring credentials in Refold

App settings page lets you configure the authentication settings for an `OAuth2` 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/USIhqTKu3QZXm8QM/images/Asana/asana_cobalt.png?fit=max&auto=format&n=USIhqTKu3QZXm8QM&q=85&s=51efaf2e4b776e481b4fad36f7454a3e" alt="Setting up application client credentials" data-path="images/Asana/asana_cobalt.png" />

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

#### Actions and triggers

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

<Tabs>
  <Tab title="Actions">
    <AccordionGroup>
      <Accordion title="Task">
        1. **Create Task** - Create a task in Asana.
        2. **Update Task** - Update a task in Asana.
        3. **Delete Task** - Delete a task in Asana.
      </Accordion>

      <Accordion title="Project">
        4. **Create Project** - Create a project in Asana.
      </Accordion>

      <Accordion title="Section">
        5. **Create Section** - Create a section in a project in Asana.
      </Accordion>

      <Accordion title="Others">
        6. **HTTP Request** - Make HTTP API calls to any Asana documented REST APIs.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Triggers">
    1. **Task Notes Updated** - Triggers when notes in a task are updated in Asana.
    2. **Task Created** - Triggers when a task is created in Asana.
    3. **Task Updated** - Triggers when a task is updated in Asana.
  </Tab>
</Tabs>