View Categories

Reconnecting / Resetting Credentials

Table of Contents

Purpose
Guide users through what happens when authentication credentials expire or break, and how to reconnect their Asana account to restore functionality.

1. Why This Happens #

  • Security salts changed: WordPress can reset authentication salts, invalidating saved tokens.
  • Credential corruption: Database or plugin errors can damage stored connection data.
  • Revoked permissions: The connected Asana user revoked access in Asana.

When this occurs, the plugin cannot authenticate with Asana. You will see a notification in the plugin settings prompting you to re‑authenticate.

2. Symptoms #

  • Tasks fail to create or update.
  • An admin notice will appear in your WordPress dashboard informing you that the Asana connection needs to be re‑authenticated.
  • Feed pages show connection errors.

3. How to Reconnect #

  1. Go to Forms → Settings → Asana Integration.
  2. If prompted, enter you Client ID and secret again, then click the Authorize button again.
  3. Log in with your Asana account and grant access.
  4. Confirm that the account now shows as connected.

4. Resetting Credentials #

If reconnecting does not work:

  1. In Asana, revoke the app’s authorization for this site/account.
  2. In WordPress, go to Forms → Settings → Asana Integration and re‑enter your Client ID and Client Secret.
  3. Click Authorize to start a fresh OAuth flow and grant access again.

5. Tips & Best Practices #

  • Use a dedicated Asana service account (not a personal user) to avoid accidental revokes.
  • If issues persist, enable Gravity Forms logging and send the logs to support.
  • After reconnecting, check dropdowns to ensure projects and users are syncing correctly.
What are your Feelings