How can we help you?

1. Overview & System Requirements

The Gravity Forms Asana Integration Premium Add-on connects your WordPress forms directly to Asana—the premier work management platform trusted by enterprise organizations and agile product teams worldwide. When team members or website visitors submit creative briefs, software bug reports, client onboarding requests, or marketing campaign proposals, copying details manually into Asana introduces operational delays and miscommunication.

With this integration, every form submission on your website automatically creates structured tasks inside specific Asana Projects and Sections. You can map task names, rich text descriptions, due dates, assignees, custom tags, and custom fields directly from form inputs. Operating over the official Asana REST API v1, entries transfer instantly with zero third-party middleware subscription costs, keeping your cross-functional teams synchronized and productive.

2. Authentication & Asana API Setup

The integration communicates with the Asana REST API v1 using encrypted Personal Access Token (PAT) authorization:

Generating Your Asana Personal Access Token

1. Log in to your Asana Workspace at app.asana.com.
2. Click your user profile avatar in the upper right corner and select Settings.
3. Navigate to the Apps tab and click Manage Developer Apps (or visit app.asana.com/0/developer-console).
4. Under Personal Access Tokens, click Create new token.
5. Provide a recognizable name (e.g. Gravity Forms Connector) and copy the generated token string to your clipboard.

Configuring in WordPress Dashboard

1. In WordPress, navigate to Forms → Settings → Asana.
2. Paste your Personal Access Token into the designated credential field.
3. Click Test Connection. The system verifies access and queries your accessible Asana workspaces. A green verification indicator confirms connection.
4. Click Save Settings.

3. Feed Configuration & Field Mapping

Feeds allow you to configure custom task creation rules for each form across your WordPress site:

Task Structure & Destination Mapping

• Target Workspace & Project: Select your target Asana Workspace and specific Project (e.g. Creative Requests, Product Backlog).
• Section Assignment: Choose the default Project Section (e.g. To Do, Incoming Requests, Triage).
• Task Name: Define task titles using dynamic merge tags (e.g. New Request: {Project_Name:2} - {Client_Company:4}).
• Task Notes (Description): Compile multi-line form inquiries, client requirements, and contact details into the main task description body.
• Assignee & Due Date: Assign tasks to specific Asana team members by email or user ID, and map form date-pickers as the task due date.

Asana Custom Fields Generic Mapping

Asana Premium, Business, and Enterprise plans support custom project fields. The add-on enables mapping:

• Custom Fields: Map form values to Asana dropdowns (Priority: High/Medium/Low), numbers (Estimated Hours, Budget), or text strings.
• Conditional Logic: Only trigger task creation when specific criteria are met—for instance, routing urgent tickets to a rapid-response sprint project.

4. Advanced Workflows & Enterprise Project Orchestration

Connecting Gravity Forms with Asana unlocks end-to-end task automation across departments:

• Automated Creative Request Intake: Clients submit design briefs through a branded Gravity Form. The integration creates an Asana task in the Creative Studio project, attaches submitted design assets, and assigns the creative director.
• Software Bug Triage: Beta testers and customers submit bug reports. Form data (browser version, OS, steps to reproduce) populates structured custom fields in the Engineering Sprint project.
• Client Onboarding Pipelines: High-value clients completing an onboarding form automatically trigger tasks across multiple departmental projects simultaneously via dual feeds.
• File Attachment Links: Uploaded attachments are embedded as secure download links directly inside the task notes, allowing assignees to review files without leaving Asana.

5. Troubleshooting & Diagnostic Error Matrix

When task synchronization encounters issues, consult the following diagnostic matrix:

6. Developer Extensibility & Filter Hooks

Developers can programmatically modify task payloads or execute custom actions upon successful synchronization:

/**
 * Filter: gform_asana_task_payload
 * Purpose: Dynamically customize task attributes before transmission to Asana REST API v1.
 * 
 * @param array $payload The formatted API request body destined for /tasks.
 * @param array $feed    The Gravity Forms Asana feed settings.
 * @param array $entry   The submitted Gravity Forms entry object.
 * @param array $form    The active form object.
 * @return array Modified task payload.
 */
add_filter( 'gform_asana_task_payload', function( $payload, $feed, $entry, $form ) {
    // Append client IP address to task notes
    $payload['notes'] .= "

Client IP: " . sanitize_text_field( rgar( $entry, 'ip' ) );

    // If submitted by logged-in user, tag with user login
    if ( is_user_logged_in() ) {
        $user = wp_get_current_user();
        $payload['notes'] .= "
Submitted by: " . $user->user_email;
    }

    return $payload;
}, 10, 4 );

/**
 * Action: gform_asana_post_task_create
 * Purpose: Record returned Asana Task ID into entry metadata.
 * 
 * @param string $task_id The created Asana Task ID.
 * @param array  $entry   The active Gravity Forms entry.
 * @param array  $form    The form object.
 */
add_action( 'gform_asana_post_task_create', function( $task_id, $entry, $form ) {
    if ( ! empty( $task_id ) ) {
        gform_update_meta( $entry['id'], '_asana_task_id', sanitize_text_field( $task_id ) );
        GFFormsModel::add_note( $entry['id'], 0, 'Asana', 'Task created in Asana. ID: ' . $task_id );
    }
}, 10, 3 );

7. Frequently Asked Questions