Instagram Analytics
Instagram Analytics: Troubleshooting
Use this page when the dashboard fails to load or metrics look off.
Common Errors
Instagram access token is not configured on the server.
Check:
- deployed backend has
IG_ACCESS_TOKENconfigured - correct stage/environment is being called
- token secret was added where the backend runtime expects it
Date validation errors (406)
- invalid format: must be
YYYY-MM-DD sinceafteruntil- range larger than 730 days
Empty dashboard sections
Usually means selected range has little/no data for that slice:
- no posts in range
- no monthly buckets
- no data for a specific top-post metric
Use Last 90d or wider range to confirm pipeline health.
Token operations
Keep token handling server-side only. Never expose Instagram access tokens to the frontend.