Setting Up the Salesforce Add-On

Pre-Requisites

Note on API Access: To utilize the Gravity Forms Salesforce Add-On, your Salesforce account must have access to the Salesforce API. For more information on this, refer to this Salesforce developer article that outlines the license types known to provide API access. Salesforce offers many promotional and trial editions that may or may not have API access. Use our Salesforce Connection Verification Tool to confirm your Salesforce account supports the required APIs for our Gravity Forms integration.

First time connection

Salesforce has added additional security requirements for new connections from connected apps, which are necessary for the Salesforce Add-On to function. Only administrations in an Organization or users with an explicitly assigned permission can install an app for the first time. Once it has been installed by completing an OAuth connection, anyone in the Organization should be able to use it.

If it is the first time connecting to Salesforce through the add-on, make sure that either:

  • An admin does the first OAuth connection, OR
  • The user installing the app has both API Access and the “Approve Uninstalled Connected Apps” permission.

If the first connection is performed by a user with either of these conditions, the connection should work correctly. After the initial connection, you should be able to switch to a non-administrator account.

Setup

  1. Log into your WordPress admin dashboard.
  2. On the left side navigation menu, hover over Forms and click on Settings.
  3. Click the Salesforce tab.
  4. Click the Connect to Salesforce button.
Image showing instructions to connect to Salesforce.
Image showing the redirect while connecting to Salesforce.

Once you have successfully authenticated your account, you will see the message Signed into Salesforce.

Image showing Salesforce connection status.

You can then set up a Salesforce feed using the instructions shown in this article.

Note: The Gravity Forms Salesforce Add-On does not support connecting to Sandbox environments.