API Error Messages in Agency AI, Decoded
Quick answer
Sometimes Agency AI shows you the raw error Meta or Google returned. Most of them mean one of three things: a permission wasn't granted, a token expired, or the platform is throttling. Find yours below. If it isn't here, or the fix doesn't clear it, email the exact text to hello@agencyai.app; API errors are usually ours to chase.
Meta
| Error text contains | Meaning | Fix | Who |
|---|---|---|---|
| "Unsupported get request. Object with ID '...' does not exist, cannot be loaded due to missing permissions, or does not support this operation" | Agency AI asked for an asset (ad account, insights, page) your authorization didn't include, or the asset was removed from the portfolio | Reconnect and tick every asset on Meta's screens. Unable to locate an ad account and page | You |
| "(#190) Error validating access token" or "Session has expired" | Token expired, password changed, or Agency AI removed from Business integrations | Reconnect | You |
| "(#200) Requires ... permission" or "(#10) Application does not have permission" | A permission was declined during authorization, or your profile lacks the role on the asset | Reconnect and approve all permissions; check your role under Business settings → Ad accounts → People. Permissions | You |
| "(#17) User request limit reached" or "(#80004) too many calls" | Meta rate limit | Wait 15 to 60 minutes and retry. Nothing to fix | Nobody |
| "product set promoted object not supported with Asset Customization" | You're adding an image or video ad to an ad set that was created in Ads Manager with a product set; it only accepts catalog creative | Create a new ad set through Agency AI (Create New Ad Set) or launch a new campaign | You |
| "Ad account is disabled" or "account is restricted" | Meta restriction | Meta restricted your account | You, with Meta |
| "Invalid parameter" with a field name, on ad creation | A value failed Meta's validation (headline too long, missing landing page, unsupported CTA) | Check the named field and the character counters, resubmit. If it persists, email us the text | You, then us |
| Error text contains | Meaning | Fix | Who |
|---|---|---|---|
| "USER_PERMISSION_DENIED" | Your Google login doesn't have Standard or Admin access on the account | Google Ads account missing | You |
| "invalid_grant" or "AUTHENTICATION_ERROR" | Token revoked or expired | Reconnect | You |
| "CUSTOMER_NOT_ENABLED" or "account has been cancelled" | The Google Ads account is cancelled or never activated | Reactivate under Google Ads → Admin → Account settings, then reconnect | You |
| "NOT_ADS_USER" | The Google login you authorized has never been added to any Google Ads account | Get access on the account, then reconnect. Details | You |
| "RESOURCE_EXHAUSTED" or "quota" | Google rate limit | Wait and retry | Nobody |
| "merchant" + "not linked" or "MERCHANT_ID_INVALID" | Merchant Center isn't linked to the connected Google Ads account | Link it | You |
| "DEVELOPER_TOKEN" anything | Our API credentials, not your account | Email us | Us |
What to send us
- The full error text, copied or screenshotted
- What you were doing (connecting, creating an ad, applying a recommendation)
- Your store URL
Email hello@agencyai.app.