Troubleshoot your Salesforce connection

Resolve Salesforce connection issues by checking supported editions, custom domain use, API access, and session settings.

May 28, 2026

Check your Salesforce edition

Geckoboard works with the following Salesforce editions:

• Enterprise
• Unlimited
• Developer
• Performance

Make sure your account uses one of these editions before moving on to the other checks.

Custom domains

Geckoboard doesn't currently support custom domains.

Confirm API access is enabled

Geckoboard needs API access on your Salesforce account to pull in data from your reports. For step-by-step instructions, see Enable API access in Salesforce.

Check your session settings

Salesforce session settings can prevent the connection when sessions are locked to the IP address from which they originated. Geckoboard authenticates and queries using a different set of IP addresses, so an IP lock will block the connection.

To resolve this and allow the connection, ask your admin to set Salesforce to lock sessions to the domain in which they were first used instead of the originating IP address. Save your changes and try connecting Geckoboard again.

Still having trouble?

If you've worked through the checks above and the connection still isn't working, get in touch, and we'll take a look.