If a Data Source is disconnected, the User who originally connected the Data Source and the Account Owner will be notified via email.
YOUR DATA SOURCE MAY BE DISCONNECTED FOR THE FOLLOWING REASONS
- Invalid credentials
- Invalid refresh token
- Insufficient privileges
- Expired token/ invalid grant
- Unique Data Source error
Invalid credentials
HOW TO
How to interpret this error
This happens when the user that connected the Data Source in Databox has changed their credentials. Since Databox gains access to your data through this user, it is imperative that they have the up-to-date credentials entered.
How to resolve this error
In Databox, navigate to Data Sources and click the Reconnect button to reconnect your disconnected Data Source.
Invalid Refresh Token
HOW TO
How to interpret this error
Refresh tokens errors can occur for the following reasons:
- Revoking Access to the Databox app
- Changing the account password
- Clicking on of those "Log out of all device" security features that some services have
- Account with which the Data Source was connected being deleted
- Too many connections have been made using the same account
- Blocked/or suspended accounts by provider (in such cases, users are not able to log in at all to their account user interface)
How to resolve this error
In Databox, navigate to Data Sources and click the Reconnect button to reconnect your disconnected Data Source.
Insufficient privileges
HOW TO
How to interpret this error
This happens when the user that connected the Data Source in Databox has lost the necessary privileges in the Data Source itself. Since Databox gains access to your data through this user, it is imperative that they have the necessary permissions.
How to resolve this error
Contact an Admin in your Data Source to restore your original user permissions. Once that's complete, in Databox navigate to Data Manager and click the Reconnect button to reconnect your disconnected Data Source.
Expired token/ invalid grant
HOW TO
How to interpret this error
This happens when the token used to establish the initial connection in Databox has expired.
Many Data Sources will set tokens to expire after a certain number of days for security purposes. For example, LinkedIn sets its token to expire after 60 days. Once the token expires, your LinkedIn Data Source will disconnect and you must re-authorize the connection in order to allow Databox to re-start data syncs.
Google Data Sources, on the other hand, have a variety of reasons why the Invalid Grant error may be returned. Learn more here.
How to resolve this error
In Databox, navigate to Data Manager and click the Reconnect button to reconnect your Data Source.
Unique Data Source error
HOW TO
How to interpret this error
There may be cases where unique Data Source errors are returned and result in disconnected Data Sources.
For example, Ahrefs requires an active subscription in order to gain API access. If your subscription status changes from active to inactive, you will see an error in Databox.
Copper Data Sources can become disconnected when the user's API key is deleted or updated.
How to resolve this error
Follow the instructions in the error message, or contact Databox Support for more information. Once that's complete, in Databox navigate to Data Manager and click the Reconnect button to reconnect your Data Source.