Skip to main content
Use the symptom below to choose the next check.

​
Authorization loop

Check the server URL, automatic OAuth client registration, browser sign-in, and workspace selection. Disconnect the stale connection in Connections → AI agents, then authorize again. If your client asks for a client ID or secret, check that you selected automatic registration. Use the connection guide for the client-specific setting.

​
Tool input error

Use the tool’s current input schema. A tool with a payload parameter needs its fields inside payload; other tools take top-level arguments. UUIDs and provider IDs are not interchangeable. For insight queries, check the metric, report specification, grain, conversion event, and attribution window with insights_capabilities. For Launcher, use discovery and fresh reads for exact media, creative version, template version, and target IDs. Follow the returned recovery hints.

​
Timeout after a write

Look up the action, activity, rule run, or launch before submitting again. A timeout can happen after acceptance. Check the tool’s retry instructions and the recorded result before trying again.

​
Get help

Include the client, approximate time, tool name, activity or run ID, and error code when contacting support. Exclude passwords, tokens, signed upload URLs, and private campaign data.