Connect links
A connect link lets someone else, usually a client of your agency, connect their own accounts to your workspace. They never share a password, never create an account with us, and approve access on Google's own consent screen: read-only for Search Console, Analytics and Bing, read and write for Sheets and Docs.
How it works
- In the dashboard, open Connect links and create a link. Choose the client it's for (optional) and the providers to ask for. One link can ask for several providers, such as Search Console, GA4 and Bing together.
- Send the link however you like: email, chat, your onboarding doc. Links look like
https://app.oneapiforagents.com/c/…. - Your client opens it, sees your workspace name and what you're asking for, and clicks Connect with Google for each provider.
- Each account appears in your workspace under that client, marked Active. Your agents can call it straight away.
What your client sees
- Your workspace's name and the client name, so they know who is asking.
- Each provider with its access next to it: Read-only, or Read and write for Sheets and Docs.
- Google's consent screen, listing the scope for each provider.
- A confirmation once everything is connected. They can close the page.
They can remove access at any time from their Google account's security settings. If they do, the next call fails with credentials_expired, the connection shows as Token expired, and you can send them a new link.
Status
| Status | Meaning |
|---|---|
| Sent | Created, not opened yet. |
| Opened | Your client opened the link but hasn't finished. |
| Completed | Every requested provider is connected. |
| Expired | The link passed its expiry date. Create a new one. |
| Revoked | You turned the link off. |
Links expire after 7 days by default (up to 30), and you can turn a link off at any time.
Scopes
| Provider | Scope | Access |
|---|---|---|
| Google Search Console | https://www.googleapis.com/auth/webmasters.readonly |
read-only |
| Google Analytics 4 | https://www.googleapis.com/auth/analytics.readonly |
read-only |
| Bing Webmaster Tools | webmaster.read |
read and write |
| Google Sheets | https://www.googleapis.com/auth/spreadsheets |
read and write |
| Google Docs | https://www.googleapis.com/auth/documents |
read and write |
We also ask Google for openid and email so the dashboard can show which Google account was connected. See the privacy policy for what each scope is used for.
Limits for your team
Members, API keys and MCP grants can be limited to some clients. A connection that belongs to a client is only visible to people and agents allowed to see that client.