---
title: Connect Asana (OAuth)
description: "**Introduction** This guide will walk you step-by-step through connecting your Asana account to IAWGF using OAuth 2.0. Once authorized, you’ll be able to configure feeds and send tasks directly to Asana. **Tip:** You’ll also get step-by-step guidance inside the plugin…"
url: "https://brightleafdigital.io/docs/connect-asana-oauth/"
updated: "2026-10-18"
category: Integrate Asana with Gravity Forms / Setup
---

# Connect Asana (OAuth)

**Introduction** This guide will walk you step-by-step through connecting your Asana account to IAWGF using OAuth 2.0. Once authorized, you’ll be able to configure feeds and send tasks directly to Asana.

**Tip:** You’ll also get step-by-step guidance inside the plugin as you go—the interface walks you through each part of the connection.

---

### Step 1: Create an Asana App

1. Go to your Asana **[My Apps](https://app.asana.com/0/my-apps)** page.
2. Click **Create new app**, name it (e.g., “Gravity Forms Integration”), and select **Integrate Asana and another tool**.
3. Accept the Asana API Terms, then click **Create app**.

![picture of the create app screen](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/Create_new_app.png)

![Creating the asana app](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/Create_app.png)

---

### Step 2: Enter App Credentials in the Plugin

1. In your Asana app's settings, go to the **Basic information** tab.
2. Copy the **Client ID** and **Client Secret**.
3. In WordPress, navigate to **GravityOps → Asana Integration → Settings** (or **Forms → Settings → Asana Integration**).
4. Paste the **Client ID** and **Client Secret** into the respective fields.
5. Click **Save**.

![screenshot of the basic info page inside the asana app](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/Basic_info_page.png)

![screenshot of the client id and secret pasted into the plugin settings](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/Client_info.png)

---

### Step 3: Configure OAuth in Asana

1. In your Asana app’s settings, open the **OAuth** tab.
2. Add the plugin’s **Redirect URL** (from Step 2 of the plugin settings) under **Authorized Redirect URIs**. Use the base plugin settings URL (without any `&step=` query parameter).
3. Choose **Full permissions** (Asana is moving to a scoped model, but for now, this ensures the plugin can fetch projects, sections, and custom fields).
4. Under the **Manage distribution** tab, add the workspace(s) you want the plugin to have access to.

![screenshot of configuring the redirect url](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/asana_redirect_url-1024x338.png)

![screenshot of adding the redirect url](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/adding_url.png)

![screenshot of configuring permissions](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/scopes-1024x322.png)

![configuring workspaces for the asana app](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/add_workspace_button-1024x580.png)

---

### Step 4: Authorize the Plugin

1. In WordPress, go to **Step 3** of the plugin settings.
2. Click **Authorize with Asana**—you’ll be redirected to Asana’s authorization screen.
3. Log in if prompted, and **approve access**. Remember to log in as a user with necessary permissions.
4. Upon success, the plugin will display a confirmation message and greet you.

![](https://brightleafdigital.io/wp-content/uploads/sites/6/2025/08/Screenshot-from-2025-08-26-18-08-37-1.png)

---

For a deeper dive into how OAuth works, including the authorization code flow, token exchange, and specific scopes used by the plugin, see the **“Explanations & Concepts”** section.