Add a custom SAML app in the Google Admin console, paste the values from this setup, turn the app on for your users and share Google’s metadata with us.
The values in braces, such as {acs_url}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.
-
Add a custom SAML app
Section titled “Add a custom SAML app”Sign in to the Google Admin console as a super administrator. Go to Menu > Apps > Web and mobile apps, select Add App > Add custom SAML app, enter an app name and select Continue.
-
Download Google’s metadata
Section titled “Download Google’s metadata”On the Google Identity Provider details page, download the IdP metadata and add it to this setup, then select Continue. Do this again whenever the certificate changes.
-
Enter the ACS URL
Section titled “Enter the ACS URL”On the Service provider details page, paste
{acs_url}into ACS URL.Paste into Google Workspace:
- ACS URL:
{acs_url}
- ACS URL:
-
Enter the entity ID
Section titled “Enter the entity ID”Paste
{sp_entity_id}into Entity ID.Paste into Google Workspace:
- SP entity ID:
{sp_entity_id}
Fixes:
saml_audience_mismatch - SP entity ID:
-
Send the email address as the name ID
Section titled “Send the email address as the name ID”Set Name ID format to EMAIL and Name ID to Basic Information > Primary email, then select Continue. Leave Signed response as it is unless your app’s support asks you to change it.
Fixes:
saml_nameid_missing -
Map the attributes
Section titled “Map the attributes”On the Attribute mapping page, select Add mapping and map Primary email to email, First name to firstName and Last name to lastName. To send groups, add them under Group membership with the app attribute groups. Select Finish.
Fixes:
saml_email_missing -
Turn the app on
Section titled “Turn the app on”Open the app, select User access, choose On for everyone (or turn it on for the right organizational units) and select Save.
Fixes:
saml_idp_status_error -
Test the connection
Section titled “Test the connection”Run a test sign-in in this setup, signing in as a user the app is turned on for. Changes in Google can take a little while to apply.
Standby sign-in is not available
Section titled “Standby sign-in is not available”Google Workspace accepts a single ACS URL per custom SAML app, so this connection cannot use the standby address. In the rare case of an outage of our main network, sign-ins pause until it ends. There is nothing to set up.
This step is optional. See standby route behavior for what the standby address does during an outage.
Sources
Section titled “Sources”- Set up your own custom SAML app (Google Workspace Admin Help), read on 2026-10-11