I Can’t Connect Salesforce — "Administrators Need to Pre-Install the Gumloop Application"

Last updated: April 27, 2026

This error means your Salesforce org hasn't authorized Gumloop's Connected App yet. A Salesforce admin needs to connect first — once they do, everyone else in the org can connect on their own.

Symptoms

  • You see a message that says administrators need to pre-install the Gumloop application so that users can connect to the instance when trying to connect Salesforce.

  • The Salesforce OAuth flow fails or never opens after you click Connect.

  • You're unsure whether you need special permissions to connect Salesforce to Gumloop.

Cause

As of September 2025, Salesforce requires a Connected App to be authorized by a Salesforce administrator before individual users in that org can complete the OAuth connection. Gumloop is a Salesforce Connected App — it is not listed on the AppExchange marketplace, so it needs to be authorized directly.

The good news: this only needs to happen once per Salesforce org. After any admin completes the connection, every other user in the same org can connect without admin involvement.

How to Fix It

If you're a Salesforce admin (or can ask one)

  1. Have your Salesforce admin go to Settings → Apps → Salesforce in Gumloop.

  2. Click Connect.

  3. Enter your Salesforce subdomain (e.g., yourcompany.my.salesforce.com).

  4. Complete the OAuth authorization in the Salesforce login window that opens.

  5. Once the admin's connection succeeds, Gumloop's Connected App is authorized for your entire Salesforce org.

After this, any user in the org can connect their own Salesforce account by following the same steps — no admin approval needed.

If someone in your org already connected Salesforce

If a colleague has already connected Salesforce to Gumloop, the Connected App is already authorized — you don't need admin help. Just connect directly:

  1. Go to Settings → Apps → Salesforce.

  2. Click Connect.

  3. Enter your Salesforce subdomain.

  4. Log in and authorize when the Salesforce window opens.

Not sure if someone already connected? Ask your team or your Salesforce admin — if any Gumloop user in your org has a working Salesforce connection, you're good to go.

If the admin sees an approval request instead

If a non-admin user tries to connect before an admin has authorized the app, the admin may see a pending approval request in Salesforce under Setup → Apps → Connected Apps → Manage Connected Apps. The admin can approve it from there, and then the user can retry their connection.

Using Salesforce After Connecting

Once connected, add Salesforce as a tool to any agent. Your agent can then query records, create and update objects, run reports, manage campaigns, and more — all conversationally.

To add Salesforce to an agent, see How to Give Your Agent Access to an Integration.

Still Need Help?

If this didn't resolve your issue, reach out to support at support@gumloop.com.

Related Docs