Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on
Google Workspace sign-in runs through a Google Cloud project. You create an OAuth client there — think of it as issuing Variable a badge that lets it ask Google “who is this person?” — and the project’s consent screen decides which Google accounts may use it.You need a Google Workspace super admin, or an admin who can create projects in your organization’s Google Cloud. Read the single sign-on overview first if you have not verified your domain in Variable.
Use the project picker to select an existing project, or choose New project and name it Variable SSO. Make sure the project belongs to your Workspace organization, not to a personal account.
Configure the consent screen
The consent screen is what people see when Google asks them to allow Variable to read their name and email.
Go to Google Auth Platform → Branding (older consoles: APIs & Services → OAuth consent screen) and complete the app name, support email and developer contact.
Under Audience, set the user type to Internal. This restricts sign-in to accounts in your Workspace organization. It is the control that keeps outside Google accounts out, so do not choose External unless you have discussed it with us.
Under Data Access, add the scopes openid, .../auth/userinfo.email and .../auth/userinfo.profile. These are the non-sensitive defaults and need no Google verification review.
With the audience set to External, any Google account can attempt to sign in and Google may show an “unverified app” warning. Internal apps skip both.
Create the OAuth client
Go to Google Auth Platform → Clients (older consoles: APIs & Services → Credentials → Create credentials → OAuth client ID) and select Create client.
Set Application type to Web application and name it Variable.
It must match exactly, including https and no trailing slash. Leave Authorized JavaScript origins empty.
Select Create, then copy the Client ID and Client secret. Keep the secret out of shared documents and chat.
Send us the credentials
Send us the following through an agreed-upon secure channel:
Provider: Google
Client ID
Client secret
The email domains to cover, each verified in Variable, including your primary Workspace domain
A contact who can test the sign-in
Google reports your organization’s primary domain for every account, including people whose address is on a secondary domain. Variable only accepts an account whose primary domain is linked to the connection, so include it even if nobody signs in with it.We confirm once it is switched on. Google client secrets do not expire on their own, but rotate yours on your usual schedule and send us the new one before you disable the old.
Test it
Open a private browser window and go to https://app.variable.global.
Enter your work email and continue. You are sent to Google.
Choose your Workspace account. You land back in Variable.
Variable passes your domain to Google as a hint, so the account picker leans toward your Workspace accounts. The hint is a convenience, not a lock. The boundary is enforced twice: the Internal audience keeps outside accounts at Google, and Variable rejects an account whose email Google has not verified or whose Workspace domain is not linked to your connection.
Troubleshooting
Google or Variable says
Cause
Fix
Error 400: redirect_uri_mismatch
The redirect URI on the OAuth client differs from the one above
Correct it under Authorized redirect URIs; changes can take a few minutes to apply
Error 401: invalid_client
Wrong client ID, or the client was deleted
Recopy the client ID from the Clients page and send it to us
Error 403: org_internal
The person signed in with an account outside your Workspace
Sign in with the Workspace account
Access blocked: ... has not completed the Google verification process
Audience is set to External
Switch the audience to Internal
Back on the sign-in page with no message
The Google account is not the address that was typed, the secret sent to us is wrong, your primary Workspace domain is not linked to the connection, or the sign-in did not start on Variable’s sign-in page in the same browser
Start from Variable’s sign-in page and sign in with the same address. If it happens again, contact us: we can check the secret and the linked domains
A setup screen asking for a company name
Signed in, but not invited to Variable and not auto-joined
To limit Variable to specific people, open the Admin console at admin.google.com, go to Security → Access and data control → API controls → Manage third-party app access, add the OAuth client by its client ID, and set access to Limited or Specific Google Workspace groups.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Variable API","colors":{"primary":"#282624","light":"#E6E3DD","dark":"#282624"},"logo":{"light":"https://app.variable.global/logo/logo-horizontal-onlight.svg","dark":"https://app.variable.global/logo/logo-horizontal-ondark.svg"},"favicon":"https://mintcdn.com/variable/-esaLwUuP4fnFDIg/logo/symbol-white.svg?fit=max\u0026auto=format\u0026n=-esaLwUuP4fnFDIg\u0026q=85\u0026s=d0fcf1de9144c23f8a7d44e3c52638a0","api":{"playground":{"display":"simple"}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"mailto:support@variable.co","label":"Support"}],"primary":{"type":"button","label":"App","href":"https://app.variable.global"}},"footer":{"socials":{"discord":"https://discord.gg/TrGYZW7zPG","linkedin":"https://www.linkedin.com/company/variable-co","x":"https://x.com/variableHQ"}},"styling":{"codeblocks":"system","latex":false},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"variable","hasAudioNarration":false,"actualSubdomain":"variable","customDomains":["docs.variable.global"],"gitSource":{"type":"github","owner":"variable-co","repo":"cascade","deployBranch":"main","contentDirectory":"api-documentation","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b006e3da671b91553224830","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"API Reference","count":87},{"language":"default","tag":"Documentation","count":31},{"language":"default","tag":"Elements","count":28},{"language":"default","tag":"Getting started","count":15},{"language":"default","tag":"Changelog","count":10},{"language":"default","tag":"Switch","count":8},{"language":"default","tag":"Concepts","count":8},{"language":"default","tag":"Help articles","count":8},{"language":"default","tag":"PACT API","count":8},{"language":"default","tag":"Activity","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"docs/sso/google-workspace","slug":"/docs/sso/google-workspace","pageMetadata":{"title":"Set up SSO with Google Workspace","description":"Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on","href":"/docs/sso/google-workspace"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Google Workspace sign-in runs through a Google Cloud project. You create an `,_jsx(_components.strong,{children:`OAuth client`}),` there — think of it as issuing Variable a badge that lets it ask Google “who is this person?” — and the project’s consent screen decides which Google accounts may use it.`]}),`\n`,_jsxs(_components.p,{children:[`You need a Google Workspace `,_jsx(_components.strong,{children:`super admin`}),`, or an admin who can create projects in your organization’s Google Cloud. Read the `,_jsx(_components.a,{href:`/docs/sso/overview`,children:`single sign-on overview`}),` first if you have not verified your domain in Variable.`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-or-choose-a-project`,children:`Create or choose a project`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open the `,_jsx(_components.a,{href:`https://console.cloud.google.com`,children:`Google Cloud console`}),` signed in with a Workspace admin account.`]}),`\n`,_jsxs(_components.li,{children:[`Use the project picker to select an existing project, or choose `,_jsx(_components.strong,{children:`New project`}),` and name it `,_jsx(_components.code,{children:`Variable SSO`}),`. Make sure the project belongs to your Workspace organization, not to a personal account.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`configure-the-consent-screen`,children:`Configure the consent screen`}),`\n`,_jsx(_components.p,{children:`The consent screen is what people see when Google asks them to allow Variable to read their name and email.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Go to `,_jsx(_components.strong,{children:`Google Auth Platform`}),` → `,_jsx(_components.strong,{children:`Branding`}),` (older consoles: `,_jsx(_components.strong,{children:`APIs \u0026 Services`}),` → `,_jsx(_components.strong,{children:`OAuth consent screen`}),`) and complete the app name, support email and developer contact.`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Audience`}),`, set the user type to `,_jsx(_components.strong,{children:`Internal`}),`. This restricts sign-in to accounts in your Workspace organization. It is the control that keeps outside Google accounts out, so do not choose `,_jsx(_components.strong,{children:`External`}),` unless you have discussed it with us.`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Data Access`}),`, add the scopes `,_jsx(_components.code,{children:`openid`}),`, `,_jsx(_components.code,{children:`.../auth/userinfo.email`}),` and `,_jsx(_components.code,{children:`.../auth/userinfo.profile`}),`. These are the non-sensitive defaults and need no Google verification review.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`With the audience set to `,_jsx(_components.strong,{children:`External`}),`, any Google account can attempt to sign in and Google may show an “unverified app” warning. Internal apps skip both.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`create-the-oauth-client`,children:`Create the OAuth client`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Google Auth Platform`}),` → `,_jsx(_components.strong,{children:`Clients`}),` (older consoles: `,_jsx(_components.strong,{children:`APIs \u0026 Services`}),` → `,_jsx(_components.strong,{children:`Credentials`}),` → `,_jsx(_components.strong,{children:`Create credentials`}),` → `,_jsx(_components.strong,{children:`OAuth client ID`}),`) and select `,_jsx(_components.strong,{children:`Create client`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Set `,_jsx(_components.strong,{children:`Application type`}),` to `,_jsx(_components.strong,{children:`Web application`}),` and name it `,_jsx(_components.code,{children:`Variable`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Authorized redirect URIs`}),`, add:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://app.variable.global/api/auth/google/callback`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`It must match exactly, including `,_jsx(_components.code,{children:`https`}),` and no trailing slash. Leave `,_jsx(_components.strong,{children:`Authorized JavaScript origins`}),` empty.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Create`}),`, then copy the `,_jsx(_components.strong,{children:`Client ID`}),` and `,_jsx(_components.strong,{children:`Client secret`}),`. Keep the secret out of shared documents and chat.`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`send-us-the-credentials`,children:`Send us the credentials`}),`\n`,_jsx(_components.p,{children:`Send us the following through an agreed-upon secure channel:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Provider: Google`}),`\n`,_jsx(_components.li,{children:`Client ID`}),`\n`,_jsx(_components.li,{children:`Client secret`}),`\n`,_jsx(_components.li,{children:`The email domains to cover, each verified in Variable, including your primary Workspace domain`}),`\n`,_jsx(_components.li,{children:`A contact who can test the sign-in`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Google reports your organization’s primary domain for every account, including people whose address is on a secondary domain. Variable only accepts an account whose primary domain is linked to the connection, so include it even if nobody signs in with it.`}),`\n`,_jsx(_components.p,{children:`We confirm once it is switched on. Google client secrets do not expire on their own, but rotate yours on your usual schedule and send us the new one before you disable the old.`}),`\n`,_jsx(Heading,{level:`2`,id:`test-it`,children:`Test it`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open a private browser window and go to `,_jsx(_components.code,{children:`https://app.variable.global`}),`.`]}),`\n`,_jsx(_components.li,{children:`Enter your work email and continue. You are sent to Google.`}),`\n`,_jsx(_components.li,{children:`Choose your Workspace account. You land back in Variable.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Variable passes your domain to Google as a hint, so the account picker leans toward your Workspace accounts. The hint is a convenience, not a lock. The boundary is enforced twice: the `,_jsx(_components.strong,{children:`Internal`}),` audience keeps outside accounts at Google, and Variable rejects an account whose email Google has not verified or whose Workspace domain is not linked to your connection.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Google or Variable says`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Error 400: redirect_uri_mismatch`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The redirect URI on the OAuth client differs from the one above`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Correct it under `,_jsx(_components.strong,{children:`Authorized redirect URIs`}),`; changes can take a few minutes to apply`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Error 401: invalid_client`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Wrong client ID, or the client was deleted`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Recopy the client ID from the `,_jsx(_components.strong,{children:`Clients`}),` page and send it to us`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Error 403: org_internal`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The person signed in with an account outside your Workspace`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Sign in with the Workspace account`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Access blocked: ... has not completed the Google verification process`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Audience is set to `,_jsx(_components.strong,{children:`External`})]}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Switch the audience to `,_jsx(_components.strong,{children:`Internal`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Back on the sign-in page with no message`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The Google account is not the address that was typed, the secret sent to us is wrong, your primary Workspace domain is not linked to the connection, or the sign-in did not start on Variable’s sign-in page in the same browser`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Start from Variable’s sign-in page and sign in with the same address. If it happens again, contact us: we can check the secret and the linked domains`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`A setup screen asking for a company name`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Signed in, but not invited to Variable and not auto-joined`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`See `,_jsx(_components.a,{href:`/docs/sso/overview#give-people-access`,children:`give people access`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`restrict-who-can-sign-in-optional`,children:`Restrict who can sign in (optional)`}),`\n`,_jsxs(_components.p,{children:[`To limit Variable to specific people, open the Admin console at `,_jsx(_components.a,{href:`https://admin.google.com`,children:`admin.google.com`}),`, go to `,_jsx(_components.strong,{children:`Security`}),` → `,_jsx(_components.strong,{children:`Access and data control`}),` → `,_jsx(_components.strong,{children:`API controls`}),` → `,_jsx(_components.strong,{children:`Manage third-party app access`}),`, add the OAuth client by its client ID, and set access to `,_jsx(_components.strong,{children:`Limited`}),` or `,_jsx(_components.strong,{children:`Specific Google Workspace groups`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Set up SSO with Google Workspace","description":"Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on","href":"/docs/sso/google-workspace"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create or choose a project","slug":"create-or-choose-a-project","depth":2,"children":[]},{"title":"Configure the consent screen","slug":"configure-the-consent-screen","depth":2,"children":[]},{"title":"Create the OAuth client","slug":"create-the-oauth-client","depth":2,"children":[]},{"title":"Send us the credentials","slug":"send-us-the-credentials","depth":2,"children":[]},{"title":"Test it","slug":"test-it","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Restrict who can sign in (optional)","slug":"restrict-who-can-sign-in-optional","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"variable","siteName":"Variable API","title":"Set up SSO with Google Workspace - Variable API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T22:53:11.939Z","originalFileLocation":"docs/sso/google-workspace.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on\">\u003cmeta data-mint-head name=\"application-name\" content=\"Variable API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Set up SSO with Google Workspace - Variable API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Variable API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.variable.global/docs/sso/google-workspace\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://variable.mintlify.site/_mintlify/api/og/v2?division=Single+sign-on\u0026amp;title=Set+up+SSO+with+Google+Workspace\u0026amp;description=Create+an+OAuth+client+in+Google+Cloud+for+your+Google+Workspace+and+send+us+the+credentials+to+switch+on+single+sign-on\u0026amp;theme=fd7c09a692b44be01087e493\u0026amp;signature=aa6fdefd638e44cfd5f7813866d1123ca5703d87890b496d225afe61fe0aee69\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Set up SSO with Google Workspace - Variable API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://variable.mintlify.site/_mintlify/api/og/v2?division=Single+sign-on\u0026amp;title=Set+up+SSO+with+Google+Workspace\u0026amp;description=Create+an+OAuth+client+in+Google+Cloud+for+your+Google+Workspace+and+send+us+the+credentials+to+switch+on+single+sign-on\u0026amp;theme=fd7c09a692b44be01087e493\u0026amp;signature=aa6fdefd638e44cfd5f7813866d1123ca5703d87890b496d225afe61fe0aee69\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Variable API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#282624\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.variable.global/docs/sso/google-workspace\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/sso/google-workspace.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.variable.global/#organization\",\"name\":\"Variable API\",\"url\":\"https://docs.variable.global\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://app.variable.global/logo/logo-horizontal-onlight.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.variable.global#website\",\"name\":\"Variable API\",\"url\":\"https://docs.variable.global\",\"publisher\":{\"@id\":\"https://docs.variable.global/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.variable.global/docs/sso/google-workspace#webpage\",\"url\":\"https://docs.variable.global/docs/sso/google-workspace\",\"name\":\"Set up SSO with Google Workspace\",\"description\":\"Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on\",\"dateModified\":\"2026-11-14T22:53:11.939Z\",\"isPartOf\":{\"@id\":\"https://docs.variable.global#website\"},\"breadcrumb\":{\"@id\":\"https://docs.variable.global/docs/sso/google-workspace#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.variable.global/docs/sso/google-workspace#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Single sign-on\",\"item\":\"https://docs.variable.global/docs/sso/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Set up SSO with Google Workspace\",\"item\":\"https://docs.variable.global/docs/sso/google-workspace\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.variable.global/docs/sso/google-workspace#article\",\"headline\":\"Set up SSO with Google Workspace\",\"name\":\"Set up SSO with Google Workspace\",\"description\":\"Create an OAuth client in Google Cloud for your Google Workspace and send us the credentials to switch on single sign-on\",\"url\":\"https://docs.variable.global/docs/sso/google-workspace\",\"mainEntityOfPage\":{\"@id\":\"https://docs.variable.global/docs/sso/google-workspace#webpage\"},\"dateModified\":\"2026-11-14T22:53:11.939Z\",\"publisher\":{\"@id\":\"https://docs.variable.global/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.variable.global#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Variable API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Variable API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/sso/google-workspace.md","siteName":"Variable API","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Getting started","pages":[{"title":"Welcome to Variable","href":"/docs/getting-started/welcome"},{"title":"Creating your first Product (LCA)","href":"/docs/getting-started/create-first-product"},{"title":"Adding inputs to your Product (LCA)","href":"/docs/getting-started/add-materials"},{"title":"Assigning datasets","href":"/docs/getting-started/assign-datasets"},{"title":"Tracking activities","href":"/docs/getting-started/track-activities"}]},{"group":"Help articles","pages":[{"title":"Life-cycle stages explained","href":"/docs/help/life-cycle-stages"},{"title":"Environmental impact indicators","href":"/docs/help/impact-indicators"},{"title":"Assigning a supplier in bulk","href":"/docs/help/assign-supplier"},{"title":"Mapping Activities to an Element in bulk","href":"/docs/help/bulk-map-activities"},{"title":"Documenting an element","href":"/docs/help/element-documentation"},{"title":"Model CSV export","href":"/docs/help/model-csv-export"},{"title":"Mass balance","hidden":true,"href":"/docs/help/mass-balance"},{"title":"Saved views","href":"/docs/help/saved-views"},{"title":"Background tasks","href":"/docs/help/background-tasks"},{"title":"Supplying values an automation run needs","hidden":true,"href":"/docs/help/automation-needs-input"}]},{"group":"Data import","pages":[{"title":"Data import overview","href":"/docs/import/import-overview"},{"title":"Import behavior by type","href":"/docs/import/import-behavior"},{"title":"Uploading and mapping columns","href":"/docs/import/upload-map-columns"},{"title":"Import troubleshooting","href":"/docs/import/import-troubleshooting"},{"group":"Bill of materials","pages":[{"title":"Preparing your BOM file","href":"/docs/import/prepare-bom"},{"title":"What happens after upload","href":"/docs/import/import-materials"}]}]},{"group":"Concepts","pages":[{"title":"Data model","href":"/docs/data-model"},{"title":"Products \u0026 materials","href":"/docs/material"},{"title":"Datasets","href":"/docs/dataset"},{"title":"Impacts","href":"/docs/impacts"},{"title":"Models \u0026 inputs","href":"/docs/model"},{"title":"Switch","href":"/docs/switch"},{"title":"Activity","href":"/docs/activity"},{"title":"syncId","href":"/docs/syncId"}]},{"group":"Single sign-on","pages":[{"title":"Single sign-on","href":"/docs/sso/overview"},{"title":"Set up SSO with Microsoft Entra ID","description":"Register Variable as an app in Microsoft Entra ID (Azure AD) and send us the credentials to switch on single sign-on","href":"/docs/sso/azure-ad"},{"title":"Set up SSO with Google Workspace","href":"/docs/sso/google-workspace"}]},{"group":"Security","pages":[{"title":"Security","description":null,"href":"/docs/security"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/welcome"}]},{"tab":"PACT API","pages":[{"title":"PACT API","href":"/pact-api/welcome"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/welcome"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026"}]}]},"basePath":"","title":"Set up SSO with Google Workspace - Variable API","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}