AdCopilot docsby Atromx
Troubleshooting

Troubleshooting

Look up the error or message you got, a Google code or AdCopilot's own words, and get the one-line fix, who does it and the full steps. Support is here too.

View as Markdown
Open inClaudePerplexity

Sent here by your assistant? Find the words it quoted under Find your error, or what is going wrong under Find your symptom. Each row gives the fix in one line and who does it; the link has the full steps. Rows marked Assistant need nothing from you. AI assistants: read For AI assistants as well.

Who: Assistant, the AI fixes its own call; You, the person using AdCopilot; Owner, the workspace owner; Wait, Google is busy or a limit was reached. "Owner, then You": the owner first. "You, or Owner": either.

Find your error

Search this page for the code in capitals or the message's first words. Google's errors come in Google's words, for example Google Ads rejected the query: query_error UNRECOGNIZED_FIELD: …. Below, … stands for a name or a number.

Google access and accounts

What you seeWhoFix
USER_PERMISSION_DENIED (Google may mention a login-customer-id header)YouThe Google login your assistant uses (the Google Ads card on Google products names it) can't open that account. Give that login access in Google Ads, or connect the login that has it. Refresh accounts alone won't help.
CUSTOMER_NOT_ENABLEDYou, or OwnerThe account isn't active yet, or was cancelled. Finish setting it up in Google Ads, or an owner switches it Off under Ad accounts. Reconnecting won't help.
NOT_ADS_USERYouThat Google login has no Google Ads account. Connect the login that has one.
REQUESTED_METRICS_FOR_MANAGEROwnerA manager (MCC) account is switched on. Switch on a client account under it, and the manager off.
"AdCopilot hasn't found account …"You, then OwnerGive one of the workspace's Google logins access to it in Google Ads; then the owner presses Refresh accounts.
"… switched on for this workspace but not shared with you"OwnerAsk the workspace owner to have it shared with you. Nothing changes in Google Ads.
"AdCopilot could not read the account just now"AssistantA first read failed. Never guess numbers; follow the fallback reads and look up any read's error here.
Search Console: "User does not have sufficient permission for site"Assistant, then YouUse the site exactly as gsc_list_sites lists it. Not listed: the connected login has no access to it.
Analytics or Tag Manager: HttpError 403 PERMISSION_DENIEDAssistant, then YouUse the ids the list tools return. Missing: the connected login has no access in that product.
"Google is no longer accepting this connector's sign-in"YouOpen the reconnect link in the message or the email, and sign in to Google again.
"Google would not renew AdCopilot's access to …" (Google said: invalid_scope …)YouOpen the link in the message, or press Reconnect … on that product's card in Google products.
"Google's sign-in service could not renew AdCopilot's access to … just now"WaitGoogle's side. Ask again in a few minutes; reconnecting won't help.
"… isn't connected to this workspace yet"YouOpen the link in the message, or press that product's Connect … button. Nothing to do in your AI app.
"… is connected in this workspace through a teammate's Google login, not yours"YouConnect it with your own Google login on Google products.
"… is connected read-only, so I can't make changes there"YouOpen the link in the message, or press Enable editing on its card.
"… is not available through this connector's current authorisation"YouConnect your AI → Revoke the app, or remove and re-add AdCopilot in your AI app.
"Account … is switched off for this workspace"OwnerSwitch it On under Ad accounts, or swap it with the one that is on.
"… is not recorded as having access to it" or "… had access to no Google Ads account"YouYour login can't open it; nothing was sent. Get it access in Google Ads, then ask again in ten minutes, or the owner presses Refresh accounts.
"… AdCopilot has not yet checked which Google Ads accounts …"Owner, then YouNothing was sent. The owner presses Refresh accounts; still refused, your login needs access in Google Ads.

Connecting and signing in

What you seeWhoFix
Approve on "Let Cursor use your AdCopilot?" does nothingYouFixed: remove AdCopilot in Cursor, add it again, and press Approve once.
"That connection request isn't valid"YouStart the connection again from inside your AI app, and finish in the browser it opens.
"Finish in the browser you started in"YouGo back to the browser your assistant opened, or start connecting again from the assistant.
"Sign in again in this browser"YouPress Sign in again.
Every product "isn't connected", though the dashboard shows it connectedYouThe assistant was approved for another workspace. Revoke it and approve the right one.
Email "AdCopilot disconnected … as a precaution"YouReconnect AdCopilot in that assistant.
unauthorized, or "refresh token is invalid or already used"YouReconnect AdCopilot in your AI app and approve it again.
"invalid or inactive access URL"OwnerYou were paused or removed, or the workspace was switched off. Ask the owner: a seat added, or a paid plan that holds everyone, brings a paused person back.
"this trial connector has expired"OwnerChoose a plan on the Billing page.
"This connector URL has been retired"YouAdd AdCopilot again with https://mcp.adcopilot.cloud/mcp.
invalid_redirect_uri, invalid_request or access_denied while signing inYouaccess_denied: you pressed Cancel; start again. The others: the client can't use AdCopilot's sign-in.
The client asks for an API keyYouThere is none. Choose the client's OAuth sign-in.
"… available but not in this connection's tool list"YouReconnect AdCopilot in your AI app with the steps in the message.
"… tool descriptions changed after this connection's tool list was loaded"AssistantCall get_org_context with tools=[…] for the current text.

Limits, busy and slow

What you seeWhoFix
"AdCopilot's daily limit is reached …", "AdCopilot daily limit reached: …" or "Not run: same daily limit …"YouYour plan's operations for today are used. Wait for the reset or upgrade. Don't retry.
"That was … of … included operations — today is covered …" or "AdCopilot usage: that was … The rest of today is covered"YouThe week's grace day: today works, tomorrow the limit applies again.
"This workspace has … Google Ads accounts switched on and your plan includes …"OwnerSwitch some accounts off, or upgrade.
"AdCopilot's Pro trial … is paused at 1,000 operations"OwnerAdd a card on Billing to resume Pro.
"Google Ads asked AdCopilot to pause its requests for a while", "Google Ads requests were paused …" or "AdCopilot has paused Google Ads requests for today"WaitNot your plan's limit. Try again after the time it gives. Your ads keep running.
"Google Ads is busy and asked AdCopilot to slow down"WaitTry again in a minute.
"… did not start within 30 seconds because AdCopilot was busy with other analyses"WaitAdCopilot's own wait, not Google's or your plan's. Nothing changed. Try again in a minute.
Google's RESOURCE_EXHAUSTED (ResourceExhausted, "Resource has been exhausted")WaitOne of Google's limits. Wait as long as it says, or a few minutes, then try once.
"Google's keyword planning service refused this request as too frequent" or "Another keyword planning request … is already waiting"AssistantOne keyword lookup at a time per account. Put many keywords in one call; wait as told.
"Google refused keyword planning for this Google Ads account"WaitThat account's keyword planning allowance is used up until it resets.
"too many requests, slow down and retry shortly" (HTTP 429)WaitWait a minute. Still refused for hours: your own daily request limit was reached; write to support.
HttpError 502, 500 or 503; "Google Ads had a temporary internal error", "Google Ads was temporarily unavailable" or "AdCopilot could not reach Google Ads"WaitGoogle's servers. Try again in a minute. Read a change back before repeating it.
"This audit reached its time limit …"YouRun it again (finished reads are cached), or narrow it with sections.
"full_audit did not finish within 60 seconds"YouTry once more, or narrow it with sections.
"This audit could not be scored: … checks were not read on this run"YouRead each not-evaluated reason first. An access error needs fixing; running it again won't help.

Budget checks and refused changes

What you seeWhoFix
"Nothing about this business is saved for this workspace yet, so I won't build …"YouSay what you sell, where your customers are and the daily amount you're comfortable with.
"No comfortable daily budget is saved …"YouSay your daily number. AdCopilot saves it; ask again.
"… above the comfortable daily budget on file … a heads-up, not a block"YouA warning: the change went through.
"… above the monthly cap of … on file"YouRaise the cap, pick a smaller daily budget, or pause another campaign.
"I can't read the monthly cap on file …"YouSay the monthly cap you want.
"I couldn't read this campaign's daily budget from Google Ads just now"WaitNothing changed. Try again in a minute.
"Maximize Clicks with no per-click cap …"YouSay the most you'll pay for one click.
"I can't read the daily budget on this request as a plain number" (or "the per-click cap")YouSay the amount again as a plain number.
"This is the campaign we built together — switching it on is yours to do in Google Ads"YouBy design. Switch it on yourself in Google Ads.
POLICY_ERROR or a policy findingYouGoogle refused the text under the policy it names. Reword it; AdCopilot can't ask Google for an exception.
RESOURCE_LIMITYouThe account is at a Google limit for that kind of item. Reuse one, or remove one in Google Ads (AdCopilot can't); pausing often doesn't make room.
"Tool '…' is not enabled for this subscription tier."OwnerA viewer, or a read-only workspace, can't make changes.
"Your subscription is inactive"OwnerReactivate on the Billing page.

Errors your assistant fixes

What you seeWhoFix
UNRECOGNIZED_FIELDAssistantA field name is wrong. Call get_resource_metadata for that resource, use a listed field, run once more.
EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSEAssistantA field in orderings, or a segment (other than the date) in conditions, must also be in fields. Add it, run once more.
PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE, other PROHIBITED_…AssistantThat metric or segment can't be read with that resource. Drop it, or query a resource that has it.
METRIC_ACCESS_DENIEDAssistantThis account can't read that metric. Drop it, run once more.
START_DATE_TOO_OLDAssistantChange history goes back 30 days (change_event) or 90 (change_status). Use a later start_date.
"… does not take the parameter …, so nothing was run"AssistantCall again with the parameter names the message lists. Never add a manager account ID.
"image_source must be an http:// or https:// address …"AssistantPass the image's web address, or the image itself as a data: URI.
Analytics: "Selected dimensions and metrics cannot be queried together"AssistantChange the dimension and metric mix (ga4_get_metadata lists them), run once more.
TOO_LONGAssistantA text is over Google's length limit. Shorten the field Google names and show the user the new text.
CONCURRENT_MODIFICATIONAssistantSomething changed the same item at the same moment. Read it again, then try once more.
"Setting status to REMOVED …"AssistantAdCopilot cannot delete. Pause it instead.
Any other "Google Ads rejected the query", or a raw GoogleAdsExceptionAssistantRead Google's code and message, fix the call, run once more. Fails again: tell the user Google's message.

Reasons in the Tool calls list

A refused call in the dashboard's Tool calls list, on Usage, shows a short reason:

ReasonWhat it means
cap_dailyDaily operations used.
cap_accountsMore accounts switched on than the plan includes.
trial_pausedA trial paused at 1,000 operations, its Free day used.
build gate, budget fence, first campaignA budget check refused a change. Normal while you set up.
product not connected, product read-only, token scopeA Google product is not connected, is read-only, or is not covered by the assistant's approval.
account out of scope, account not on your loginSwitched off, never found in this workspace, or not on your own Google login.
account out of scope: switched offSwitched off.
account out of scope: not discoveredNever found through the workspace's Google logins.
account out of scope: not sharedNot shared with that person.
unknown argument, unknown argument: …, image_source not a URL, status sent to update_campaign, retired field nameThe assistant used a wrong parameter, tool or field name. Nothing for you to do.
build status not PAUSEDThe assistant asked to build a campaign switched on. Every campaign is built paused; switch it on in Google Ads.
scheduled runA scheduled run asked for a change; it makes none. Ask for it in a new chat.
google grant rejectedGoogle stopped accepting the sign-in.
tierA viewer or a read-only workspace tried a change.
suspendedThe subscription is inactive.
google ops ceiling, GoogleOpsRefused, GoogleAdsBusy, ResourceExhausted, InternalServerError, ServiceUnavailable, KeywordPlanning…Google is busy or failing, or a shared limit was reached. Nothing to fix in your account.
ToolError: RefreshError …, google sign-in renewal failedGoogle would not renew access to that product.
ToolError: and a Google code or HttpError …Google refused the call. Look the code up above.

Find your symptom

For AI assistants

  • Fix your own call first. A wrong field or parameter name, a field missing from fields, a text over Google's length limit: correct the call yourself and run it once more. get_resource_metadata lists a resource's fields and does not count against the daily operations. Don't ask the user to fix a query.
  • Retry once, not in a loop. After fixing a call, run it once more. If Google says it is busy, wait as long as the message says, then try once. Don't retry an access refusal (USER_PERMISSION_DENIED, CUSTOMER_NOT_ENABLED, not connected, switched off): only the user's step changes it. Don't retry the plan's daily limit or a Google Ads pause before the time it gives.
  • Tell the user plainly. When the fix is theirs, quote the error, give the one step from the row above with its dashboard label, and stop.
  • Never ask for credentials. No password, Google sign-in code, token, developer token or API key. There is no API key: sign-in is OAuth in the browser. Never send a manager account ID on a call; AdCopilot reaches an account through its manager by itself.
  • Read before you repeat a change. A call can stop partway, or Google may not say whether a change was applied, so read the item back first.
  • This page as plain text: troubleshooting.md.

Common questions

Is there an API key? No. Sign-in is OAuth in your browser, and the connector URL holds no secret. See There is no API key.

Does it work with Cursor, VS Code or another assistant? Yes, with any assistant that can add a remote MCP server by its URL and sign in through your browser. See Which assistants work.

Can AdCopilot set a Search campaign's language? No. Google removed it from Search campaigns in late September 2026 and goes by the ads' own language, so write them in your customers' language and block other-language searches with negative keywords. Performance Max, Display and Video still have one; see Campaign tools.

Contact support

Still stuck? Write to support@adcopilot.cloud with:

  • your workspace's name;
  • the assistant you used (Claude, ChatGPT, Cursor, …);
  • roughly when it happened, with your time zone;
  • the exact error text, copied, and what you asked for;
  • the Google Ads account's name, if it is about one account.

Never send a password, a sign-in code, a token, or a screenshot that shows one.

On this page