;}%20.st6{fill:url(%23SVGID_00000021089067129159788970000008246765442136188072_);}%20.st7{fill:url(%23SVGID_00000117639240116366130650000015074833605515028638_);}%20.st8{opacity:0.4;fill:url(%23SVGID_00000101781798616409025840000016567063639337360777_);}%20.st9{opacity:0.4;fill:url(%23SVGID_00000052086836598721292040000002033117744178971046_);}%20.st10{opacity:0.4;fill:url(%23SVGID_00000159460939004760751800000002448009281983951536_);}%20.st11{opacity:0.4;fill:url(%23SVGID_00000013177830667419993080000017721442101626521532_);}%20.st12{opacity:0.4;fill:url(%23SVGID_00000152235521444854938490000006526001119318383285_);}%20.st13{opacity:0.4;fill:url(%23SVGID_00000119823135212293698520000012774889010992664993_);}%20%3c/style%3e%3cg%3e%3cpolygon%20class='st2'%20points='134.78,14.22%20114.31,48.21%20101.33,69.75%20158.22,69.75%20177.97,36.95%20191.67,14.22%20'/%3e%3cpolygon%20class='st3'%20points='227.55,69.75%20186.61,69.75%20101.33,69.75%20129.78,119.02%20158.16,119.02%20228.61,119.02%20256,119.02%20'/%3e%3cpolygon%20class='st3'%20points='136.93,132.47%20116.46,167.93%2073.82,241.78%20130.71,241.78%20144.9,217.2%20180.13,156.18%20193.82,132.46%20'/%3e%3cpolygon%20class='st3'%20points='121.7,131.95%20101.23,96.49%2058.59,22.63%2030.15,71.91%2044.34,96.49%2079.57,157.5%2093.26,181.22%20'/%3e%3cpolygon%20class='st2'%20points='64.81,131.95%2025.15,131.21%200,130.74%2028.44,180.01%2066.73,180.72%2093.26,181.21%20'/%3e%3cpolygon%20class='st2'%20points='165.38,181.74%20184.58,216.46%20196.75,238.47%20225.19,189.2%20206.66,155.69%20193.83,132.46%20'/%3e%3c/g%3e%3c/svg%3e)
Windmill HubGoogle Chat
Communication OAuth, or a webhook URLRead and post Google Chat messages from any Windmill script, flow or app, as the connected Workspace user, or send notifications to a space through its incoming webhook.
Set up in 3 steps
Configure a Chat app in Google Cloud
Google only serves the Chat API to projects that have a Chat app. The instance admin, in the Google Cloud project that holds Windmill's Google OAuth client, enables the Google Chat API and fills in its Configuration page (name, avatar, description), once.
Connect from the Resources page
Open Resources, click Add a resource/API and pick gchat under Instance-configured OAuth APIs. Click Connect and sign in with a Google Workspace account, then name the resource and save it.
Run your first script
Fork list spaces to find a space, then send a message to it.
Scripts
Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.
Resource types
The credential shapes the scripts on this page expect — pick the one your script asks for.
gchat
View raw schema →| Field | Type | Required | What it is |
|---|---|---|---|
| token | string | Yes | OAuth access token. Connect with OAuth so Windmill refreshes it; Google access tokens expire after about an hour. |
gchat_webhook
View raw schema →| Field | Type | Required | What it is |
|---|---|---|---|
| url | string | Yes | Webhook URL (https://chat.googleapis.com/v1/spaces/.../messages?key=...&token=...). It grants posting to the space, so keep it secret. |
Questions
Does it work with a personal @gmail.com account?
No. The Chat API only accepts Google Workspace accounts for user authentication.
Listing messages or members fails on a missing scope
The default connection can list and read spaces and send messages, but not read messages or members. Reading messages needs chat.messages.readonly (a restricted scope, so off by default) and reading members needs chat.memberships.readonly. Reconnect and tick them in the scope options.
Why do I get "Google Chat app not found"?
The Google Cloud project behind the OAuth client has no Chat app configured. Enable the Chat API in that project and complete its Configuration page.
Do messages come from a bot?
Not with the OAuth connection: messages are posted as the connected user, with the same membership and permissions they have in Chat. Send Message via Webhook posts as the webhook instead, under the name and avatar set when it was created.
How do I post to a space with a webhook instead of OAuth?
In Chat on the web, open the space, click its name > Apps & integrations > Add webhooks, name it and save, then copy the webhook link. In Windmill, create a gchat_webhook resource with that link as url (the link alone grants posting, so you can bind the field to a secret variable with $var:<path>), and run Send Message via Webhook with text, cards_v2 or both. Set thread_key to keep related notifications in one thread. Google limits each space to 1 request per second across all its webhooks; above that the script fails with a 429. Webhooks need a Business or Enterprise Workspace whose admin allows them.
There is no Connect button on my instance
An instance admin has to add a Google OAuth client once, under Instance settings → Auth/OAuth/SAML → OAuth, before the tile appears.