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 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.

---

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.

---

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 the plugin settings) under Authorized Redirect URIs—omit the &step=3 suffix if present.
3. When asked, choose Full permissions for now. Note: Asana is moving to a scoped permissions model where you will need to select specific scopes for both new and existing integrations. See more details here.
4. Under the Manage distribution tab, add the workspace(s) you want the plugin to have access to.

---

Step 4: Authorize the Plugin #

1. In WordPress, go to Step 4 of the plugin settings.
2. Click Authorize—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.

---

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.