Did you receive an error when you tried to connect Nutshell to your Gmail or G Suite account? Follow these troubleshooting tips.
Nutshell follows strict communication standards to talk to Google for your data. Sometimes things don't work out when trying to access your data and the result is an error message. There are a few things you can do to make sure the Nutshell + G Suite connection is correctly configured.
Approve Nutshell data access in your G Suite control panel
Any time there is a new requirement for data access (e.g., contact importing) we need an administrator from your G Suite domain to authorize access.
Common errors
- Requested client not authorized
- Authentication failed
Steps:
Note: You must be a G Suite administrator to do this.
- Go to Gmail and click the Gear icon on the top right and click "Manage this domain" or go to admin.google.com
- Click the Apps icon
- Click Marketplace apps
- Click Data access
- Click Grant data access
If you see that the access is already granted, try revoking then re-granting access.

Learn more: "Google Apps: Change the settings for an app"
Enable API Access
Common errors
- Administrator setup required
- Error refreshing the 0Auth2 token, message: ' { "error" : "invalid_grant" , "error_description" : "Token has been revoked." } '
- There was a sync error while updating the activity on your Google Calendar. Please check that you have granted it the proper permissions.
Steps:
Note: You must be a G Suite administrator to do this.
- Go to Gmail and click the Gear icon on the top right and click "Manage this domain" or go to admin.google.com
- Click Security
- Click API reference
- Check the box next to "Enable API access"
- Click "Save changes"

Enable IMAP in General Settings
Steps:
- Go to Gmail and click the Gear icon on the top right and click, Settings.
- Click Forwarding and POP/IMAP
- Make sure Enable IMAP is selected
Wrong email address was used for access
For certain data requests to G Suite, Nutshell must supply an email address for the target user. This email address must be the primary email that G Suite uses to identify the user. When this is the case, there will be a list of emails on your account to select from, you should select the email address you use to log into your G Suite account.
Network error
These temporary issues between our servers and Google usually work themselves out on their own. Nothing wrong with waiting a minute or two and trying again.
Comments
0 comments
Please sign in to leave a comment.