- The consent screen is yours. You approve an app you created and control, not a shared one.
- The API quota is yours. Your Google API usage counts against your own Google Cloud project, not a pool shared with other Bonsai users.
- Your organization requires it. A Workspace admin can allow their own app where an unknown third-party app would be blocked.
This is an advanced, optional setup. Google is the only service that supports
it today, and everything works without it — if you never touch this, Bonsai’s
built-in client keeps working. If your organization publishes its own client
through Bonsai, it applies automatically and there is nothing to set up.
1. Create the client in Google Cloud
You create the OAuth client on Google’s side, in the Google Cloud console. Bonsai shows these same steps in the app, with an Open Google setup guide button that takes you to the right console page.1
Create or pick a project
In the Google Cloud console, create a project or pick an existing one.
2
Enable the APIs you need
Under APIs & Services › Library, enable the APIs your workflows need —
for Bonsai today that’s the Gmail and Google Calendar APIs.
3
Set the user type
Under Google Auth Platform › Audience — part of the OAuth consent screen
settings — set the user type. On a Google Workspace account choose
Internal. A personal Gmail account has no organization, so Internal
is greyed out there: choose External.
4
External only: stay in testing mode and add yourself
On the External path only, still under Audience: leave the publishing
status on Testing, and add your own Google address under Test users.
5
Create the client
Under Google Auth Platform › Clients, create an OAuth client of type
Desktop app, and keep its ID and secret to hand.
- Internal skips Google’s verification and CASA review even for restricted scopes, so prefer it when you can select it.
- On the External path, an address missing from Test users is refused at sign-in.
- Google warns during sign-in that an unverified app is unsafe — continue via Advanced.
- External testing-mode access lapses after seven days, so expect to reconnect weekly.
2. Register it in Bonsai
1
Open the Google connection
Open a Google app in the App Store — Gmail, for example — and choose
Connection settings in its Connections section. On the connection
page, choose Options before the first connection, or More → Options
once connected.
2
Choose to use your own client
Expand Advanced: use your own OAuth client and choose Use my own
client.
3
Paste the ID and secret
Bonsai asks for the client ID and secret in a secure prompt — they never
appear on the settings page itself. Bonsai checks the ID looks like a real
Google client ID and refuses its own built-in one, so you can’t accidentally
register a client that isn’t yours.
4
Connect your account
Saving the client also selects it, so you don’t need to flip anything — just
connect your Google account. A toggle (Bonsai’s built-in client / Your
own OAuth client) appears alongside, for switching back and forth later.