Create Google Group
Creates Google Workspace groups with configurable settings and ownership
Creates a Google Workspace group with configurable settings and automatically assigns ownership to a specified user.
Setup Requirements
Before using this tool, you must configure Google service account authentication with proper domain-wide delegation. This requires Google Workspace Super Admin access.
Quick Reference
Required APIs:
- Admin SDK API
- Groups Settings API
Required OAuth Scopes:
https://www.googleapis.com/auth/admin.directory.group,https://www.googleapis.com/auth/apps.groups.settings
Google Admin Console Path: Menu > Security > Access and data control > API controls > Manage Domain Wide Delegation
Step-by-Step Setup
Step 1: Enable Required APIs in Google Cloud Console
- Go to the Google Cloud Console
- Select your project (or create a new one)
- Navigate to APIs & Services > Library
- Search for and enable the following APIs:
- Admin SDK API - Click "Enable"
- Groups Settings API - Click "Enable"
Step 2: Create Service Account
- In Google Cloud Console, go to IAM & Admin > Service Accounts
- Click + CREATE SERVICE ACCOUNT
- Fill in the details:
- Service account name:
google-groups-automation(or your preferred name) - Service account ID: Will auto-populate
- Description:
Service account for Google Groups creation tool
- Service account name:
- Click CREATE AND CONTINUE
- Skip the optional steps and click DONE
Step 3: Enable Domain-Wide Delegation
- In the Service Accounts list, click on your newly created service account
- Go to the Details tab
- In the Advanced settings section, check Enable Google Workspace Domain-wide Delegation
- Enter a Product name for the consent screen:
Google Groups Tool - Click SAVE
- Important: Copy the Client ID from the service account details - you'll need this for Step 5
Step 4: Create and Download Service Account Key
- Still in your service account details, click the KEYS tab
- Click ADD KEY > Create new key
- Select JSON format
- Click CREATE
- The JSON file will download automatically - save this securely
Step 5: Configure Domain-Wide Delegation in Google Workspace
- Go to Google Admin Console
- In the menu, navigate to Security > Access and data control > API controls
- Click Manage Domain Wide Delegation
- Click Add new
- Enter the following details:
- Client ID: Paste the Client ID from Step 3
- OAuth scopes:
https://www.googleapis.com/auth/admin.directory.group,https://www.googleapis.com/auth/apps.groups.settings
- Click Authorize
Step 6: Configure the Tool in Risotto
- In the Risotto dashboard, select Tools in the sidebar.
- In the Tool groups list, select Google.
- Find Create Google Group and click Set up.
- Fill in the tool configuration:
- Service Account JSON file: The downloaded JSON key file
- Domain: Your Google Workspace domain (e.g., "company.com")
- Admin User Email: Email of a user with Super Admin or Groups Admin privileges
- Default Group Settings: Optional default settings for created groups
Configuration Options
When configuring this tool in a runbook, you can set:
- Group Name - Display name for the group
- Group Email - Email address for the group (e.g., team@company.com)
- Owner Email - Email of the user who will own the group
- Description - Description of the group's purpose
Limitations
- The tool acts as the admin user that you set in Admin User Email.
- The tool checks only that the group email ends with your configured domain. It does not check whether the address matches a user's email address or alias.
- The tool does not check that the owner email belongs to a user. If Google refuses to add the owner, the tool creates the group and shows the warning "Could not add <owner email> as owner".
To enforce a naming rule or require approval, attach an approval policy to the tool, or use a script tool that checks the address first.
Troubleshooting
Common Issues
Permission Requirements
The admin user specified in admin_user_email must have one of these roles:
- Super Admin (recommended)
- Groups Admin (minimum required)
Security Best Practices
- Rotate service account keys regularly (every 90 days)
- Limit OAuth scopes to only what's necessary
- Store JSON keys securely - never commit to version control
- Monitor API usage in Google Cloud Console
- Remove domain-wide delegation when no longer needed
Something wrong or missing? Report an issue · View as Markdown