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 read-only access on Google's own consent screen.
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 Read-only next to it.
- Google's consent screen, listing the read-only scope for that 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 | Google scope |
|---|---|
| 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-only) |
| Google Sheets | https://www.googleapis.com/auth/spreadsheets (read-only) |
| Google Docs | https://www.googleapis.com/auth/documents (read-only) |
We also ask for openid and email so the dashboard can show which Google account was connected.
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.