Instagram Insights Connector Troubleshooting
Invalid Field Selection
Description
One or more selected fields are not supported for Instagram account insights. Instagram only allows a limited set of metrics for account-level reporting.
Currently supported fields include:
- Followers
- Follows
- Views
- Shares
- Reach
- Comments
This error occurs when unsupported or incompatible fields are added to a chart or report.
How to fix
- Remove unsupported fields from your chart
- Use only the supported Instagram account metrics listed above
- Refresh the report after updating the field selection
Invalid Field Combination
Description
The selected metrics cannot be requested together in the same API call. Instagram enforces restrictions on which metrics can be combined in a single request.
This is an Instagram API limitation and not a Data Bloo issue.
How to fix
- Adjust your metric selection
- Split metrics across multiple charts
- Keep each chart focused on a smaller set of compatible metrics
Missing Metric Selection
Description
At least one metric must be selected to retrieve Instagram insights. If no metrics are selected, Instagram cannot return any data.
How to fix
- Edit your chart or data source configuration
- Select at least one Instagram metric
- Reload the report
Account Required
Description
No Instagram account has been selected in the connector configuration. Without selecting an account, Data Bloo cannot fetch insights data.
How to fix
- Open the Instagram Insights connector configuration
- Select at least one Instagram account
- Save the configuration and refresh the report
Account Not Found
Description
The Instagram business account could not be found. This usually happens when the account is not properly set up or linked within Meta.
Common causes include:
- The account is not a Business or Creator account
- The account is not linked to a Facebook Page
- The account is not connected to a Meta Business Portfolio
How to fix
- Convert the Instagram account to a Business or Creator account
- Link it to a Facebook Page
- Ensure it is added to a Meta Business Portfolio
- Reconnect the data source in Data Bloo
Invalid Date Range
Description
The selected date range is not supported by Instagram Insights. Instagram enforces strict limits on date ranges and historical data availability.
Platform limitations include:
- Maximum date range of 30 days per request
- Data available for the last 2 years only
- Start date must be before the end date
How to fix
- Ensure the start date is before the end date
- Limit the date range to 30 days or less
- Use valid historical dates within the last 2 years
- Refresh the report after updating dates
Permission Required
Description
Your Facebook account does not have the required permissions to access the Instagram account or linked Page data. Instagram Insights access is managed through Facebook and Meta permissions.
This error commonly occurs when:
- You are not an admin or editor of the linked Facebook Page
- Business permissions were removed or changed
How to fix
- Ask a Page or Business admin to grant you admin, editor, or moderator access
- Confirm permissions in Meta Business settings
- Reconnect the data source after permissions are updated
Authorization Expired
Description
Your authorization token has expired or is no longer valid. This can happen if sessions expire, permissions change, or security settings are updated on Facebook or Instagram.
How to fix
- Edit your Instagram Insights data source
- Click Reconnect to reauthorize your Facebook account
- Make sure you are logged into the correct Facebook profile
- Reload your report
Connector Update Required
Description
The connector version you are using is no longer active. Older versions are deprecated to stay compliant with Meta and Instagram API updates.
How to fix
- Go to hub.databloo.com
- Disconnect the existing Instagram Insights data source
- Reconnect it to use the latest connector version
- Refresh your report
Request Timeout
Description
The request took too long to complete and was stopped by the server. This typically happens when requesting large datasets or complex metric combinations.
How to fix
- Reduce the selected date range
- Simplify metric selection
- Split data into multiple charts
Quota Limit Exceeded
Description
You have reached the maximum number of allowed API requests for your Instagram Insights connection within a short period of time.
This often happens due to frequent manual refreshes or dashboards with many charts.
How to fix
- Wait for the quota to reset
- Reduce manual refresh frequency
- Simplify dashboards to lower API usage
Service Unavailable
Description
Instagram or Data Bloo services are temporarily unavailable. This is usually caused by short-term outages or maintenance.
These issues are typically resolved automatically.
How to fix
- Wait a few minutes and try again
- Refresh the data source
- Contact Data Bloo support if the issue persists
Unexpected Error
Description
An unexpected error occurred while processing your request. This may be caused by temporary API issues, internal server errors, or unsupported edge cases.
How to fix
- Retry the request after a few minutes
- Refresh the report
- If the error persists, contact Data Bloo support and include screenshots and error details
General Best Practices
- Keep charts simple and focused
- Use only supported Instagram metrics
- Avoid complex metric combinations in a single chart
- Prefer shorter date ranges
- Use scheduled refreshes instead of frequent manual refreshes
If the issue persists, please contact us via www.databloo.com/contact and include screenshots so we can troubleshoot faster.
Did this answer your question?