Google Groups

Manage Google Workspace Groups and their members

Google Groups is part of Google Workspace, providing email-based group communication, collaboration, and access control for teams and organizations. Google Groups lets you create mailing lists, manage membership, and control permissions for both internal and external users.

This page explains how you can use Sim to automate the management of Google Groups in your workflows. With Sim, agents can create and configure groups, add or remove members, update group settings, and keep directory lists up-to-date automatically—ideal for onboarding workflows, syncing IT systems, or dynamically managing project teams.

With Google Groups, you can:

  • Centralize communications: Create team or project mailing lists for group conversations
  • Manage group membership: Add, remove, or update members with granular roles (owner, manager, member)
  • Control access: Manage who can view, post, or join; set permissions for public/private visibility
  • Collaborate across teams: Streamline communication and document sharing via group-based access
  • Automate IT tasks: Use Sim to keep group memberships current as teams change

In Sim, the Google Groups integration gives your agents API-driven control to automate common administrative tasks. Connect directly to your Google Workspace domain to add users to groups, manage lists, audit group settings, and ensure your organization’s access controls are always up-to-date—without manual overhead.

Usage Instructions

Connect to Google Workspace to create, update, and manage groups and their members using the Admin SDK Directory API.

Tools

google_groups_list_groups

List all groups in a Google Workspace domain

Input

ParameterTypeRequiredDescription
customerstringNoCustomer ID or "my_customer" for the authenticated user's domain
domainstringNoDomain name to filter groups by
maxResultsnumberNoMaximum number of results to return (1-200). Example: 50
pageTokenstringNoToken for fetching the next page of results
querystringNoSearch query to filter groups (e.g., "email:admin*")

Output

ParameterTypeDescription
groupsjsonArray of group objects
nextPageTokenstringToken for fetching next page of results

google_groups_get_group

Get details of a specific Google Group by email or group ID

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID

Output

ParameterTypeDescription
groupjsonGroup object

google_groups_create_group

Create a new Google Group in the domain

Input

ParameterTypeRequiredDescription
emailstringYesEmail address for the new group (e.g., team@example.com)
namestringYesDisplay name for the group (e.g., Engineering Team)
descriptionstringNoDescription of the group

Output

ParameterTypeDescription
groupjsonCreated group object

google_groups_update_group

Update an existing Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
namestringNoNew display name for the group (e.g., Engineering Team)
descriptionstringNoNew description for the group
emailstringNoNew email address for the group (e.g., newteam@example.com)

Output

ParameterTypeDescription
groupjsonUpdated group object

google_groups_delete_group

Delete a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier to delete. Can be the group email address (e.g., team@example.com) or the unique group ID

Output

ParameterTypeDescription
messagestringSuccess message

google_groups_list_members

List all members of a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
maxResultsnumberNoMaximum number of results to return (1-200). Example: 50
pageTokenstringNoToken for fetching the next page of results
rolesstringNoFilter by roles (comma-separated: OWNER, MANAGER, MEMBER)

Output

ParameterTypeDescription
membersjsonArray of member objects
nextPageTokenstringToken for fetching next page of results

google_groups_get_member

Get details of a specific member in a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
memberKeystringYesMember identifier. Can be the member email address (e.g., user@example.com) or the unique member ID

Output

ParameterTypeDescription
memberjsonMember object

google_groups_add_member

Add a new member to a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
emailstringYesEmail address of the member to add (e.g., user@example.com)
rolestringNoRole for the member: MEMBER, MANAGER, or OWNER. Defaults to MEMBER

Output

ParameterTypeDescription
memberjsonAdded member object

google_groups_remove_member

Remove a member from a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
memberKeystringYesMember identifier to remove. Can be the member email address (e.g., user@example.com) or the unique member ID

Output

ParameterTypeDescription
messagestringSuccess message

google_groups_update_member

Update a member

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
memberKeystringYesMember identifier. Can be the member email address (e.g., user@example.com) or the unique member ID
rolestringYesNew role for the member: MEMBER, MANAGER, or OWNER

Output

ParameterTypeDescription
memberjsonUpdated member object

google_groups_has_member

Check if a user is a member of a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
memberKeystringYesMember identifier to check. Can be the member email address (e.g., user@example.com) or the unique member ID

Output

ParameterTypeDescription
isMemberbooleanWhether the user is a member of the group

google_groups_list_aliases

List all email aliases for a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID

Output

ParameterTypeDescription
aliasesarrayList of email aliases for the group
idstringUnique group identifier
primaryEmailstringGroup's primary email address
aliasstringAlias email address
kindstringAPI resource type
etagstringResource version identifier

google_groups_add_alias

Add an email alias to a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
aliasstringYesThe email alias to add to the group

Output

ParameterTypeDescription
idstringUnique group identifier
primaryEmailstringGroup's primary email address
aliasstringThe alias that was added
kindstringAPI resource type
etagstringResource version identifier

google_groups_remove_alias

Remove an email alias from a Google Group

Input

ParameterTypeRequiredDescription
groupKeystringYesGroup identifier. Can be the group email address (e.g., team@example.com) or the unique group ID
aliasstringYesThe email alias to remove from the group

Output

ParameterTypeDescription
deletedbooleanWhether the alias was successfully deleted

google_groups_get_settings

Get the settings for a Google Group including access permissions, moderation, and posting options

Input

ParameterTypeRequiredDescription
groupEmailstringYesThe email address of the group (e.g., team@example.com)

Output

ParameterTypeDescription
emailstringThe group's email address
namestringThe group name (max 75 characters)
descriptionstringThe group description (max 4096 characters)
whoCanJoinstringWho can join the group (ANYONE_CAN_JOIN, ALL_IN_DOMAIN_CAN_JOIN, INVITED_CAN_JOIN, CAN_REQUEST_TO_JOIN)
whoCanViewMembershipstringWho can view group membership
whoCanViewGroupstringWho can view group messages
whoCanPostMessagestringWho can post messages to the group
allowExternalMembersstringWhether external users can be members
allowWebPostingstringWhether web posting is allowed
primaryLanguagestringThe group's primary language
isArchivedstringWhether messages are archived
archiveOnlystringWhether the group is archive-only (inactive)
messageModerationLevelstringMessage moderation level
spamModerationLevelstringSpam handling level (ALLOW, MODERATE, SILENTLY_MODERATE, REJECT)
replyTostringDefault reply destination
customReplyTostringCustom email for replies
includeCustomFooterstringWhether to include custom footer
customFooterTextstringCustom footer text (max 1000 characters)
sendMessageDenyNotificationstringWhether to send rejection notifications
defaultMessageDenyNotificationTextstringDefault rejection message text
membersCanPostAsTheGroupstringWhether members can post as the group
includeInGlobalAddressListstringWhether included in Global Address List
whoCanLeaveGroupstringWho can leave the group
whoCanContactOwnerstringWho can contact the group owner
favoriteRepliesOnTopstringWhether favorite replies appear at top
whoCanApproveMembersstringWho can approve new members
whoCanBanUsersstringWho can ban users
whoCanModerateMembersstringWho can manage members
whoCanModerateContentstringWho can moderate content
whoCanAssistContentstringWho can assist with content metadata
enableCollaborativeInboxstringWhether collaborative inbox is enabled
whoCanDiscoverGroupstringWho can discover the group
defaultSenderstringDefault sender identity (DEFAULT_SELF or GROUP)

google_groups_update_settings

Update the settings for a Google Group including access permissions, moderation, and posting options

Input

ParameterTypeRequiredDescription
groupEmailstringYesThe email address of the group (e.g., team@example.com)
namestringNoThe group name (max 75 characters)
descriptionstringNoThe group description (max 4096 characters)
whoCanJoinstringNoWho can join: ANYONE_CAN_JOIN, ALL_IN_DOMAIN_CAN_JOIN, INVITED_CAN_JOIN, CAN_REQUEST_TO_JOIN
whoCanViewMembershipstringNoWho can view membership: ALL_IN_DOMAIN_CAN_VIEW, ALL_MEMBERS_CAN_VIEW, ALL_MANAGERS_CAN_VIEW
whoCanViewGroupstringNoWho can view group messages: ANYONE_CAN_VIEW, ALL_IN_DOMAIN_CAN_VIEW, ALL_MEMBERS_CAN_VIEW, ALL_MANAGERS_CAN_VIEW
whoCanPostMessagestringNoWho can post: NONE_CAN_POST, ALL_MANAGERS_CAN_POST, ALL_MEMBERS_CAN_POST, ALL_OWNERS_CAN_POST, ALL_IN_DOMAIN_CAN_POST, ANYONE_CAN_POST
allowExternalMembersstringNoWhether external users can be members: true or false
allowWebPostingstringNoWhether web posting is allowed: true or false
primaryLanguagestringNoThe group's primary language (e.g., en)
isArchivedstringNoWhether messages are archived: true or false
archiveOnlystringNoWhether the group is archive-only (inactive): true or false
messageModerationLevelstringNoMessage moderation: MODERATE_ALL_MESSAGES, MODERATE_NON_MEMBERS, MODERATE_NEW_MEMBERS, MODERATE_NONE
spamModerationLevelstringNoSpam handling: ALLOW, MODERATE, SILENTLY_MODERATE, REJECT
replyTostringNoDefault reply: REPLY_TO_CUSTOM, REPLY_TO_SENDER, REPLY_TO_LIST, REPLY_TO_OWNER, REPLY_TO_IGNORE, REPLY_TO_MANAGERS
customReplyTostringNoCustom email for replies (when replyTo is REPLY_TO_CUSTOM)
includeCustomFooterstringNoWhether to include custom footer: true or false
customFooterTextstringNoCustom footer text (max 1000 characters)
sendMessageDenyNotificationstringNoWhether to send rejection notifications: true or false
defaultMessageDenyNotificationTextstringNoDefault rejection message text
membersCanPostAsTheGroupstringNoWhether members can post as the group: true or false
includeInGlobalAddressListstringNoWhether included in Global Address List: true or false
whoCanLeaveGroupstringNoWho can leave: ALL_MANAGERS_CAN_LEAVE, ALL_MEMBERS_CAN_LEAVE, NONE_CAN_LEAVE
whoCanContactOwnerstringNoWho can contact owner: ALL_IN_DOMAIN_CAN_CONTACT, ALL_MANAGERS_CAN_CONTACT, ALL_MEMBERS_CAN_CONTACT, ANYONE_CAN_CONTACT
favoriteRepliesOnTopstringNoWhether favorite replies appear at top: true or false
whoCanApproveMembersstringNoWho can approve members: ALL_OWNERS_CAN_APPROVE, ALL_MANAGERS_CAN_APPROVE, ALL_MEMBERS_CAN_APPROVE, NONE_CAN_APPROVE
whoCanBanUsersstringNoWho can ban users: OWNERS_ONLY, OWNERS_AND_MANAGERS, NONE
whoCanModerateMembersstringNoWho can manage members: OWNERS_ONLY, OWNERS_AND_MANAGERS, ALL_MEMBERS, NONE
whoCanModerateContentstringNoWho can moderate content: OWNERS_ONLY, OWNERS_AND_MANAGERS, ALL_MEMBERS, NONE
whoCanAssistContentstringNoWho can assist with content metadata: OWNERS_ONLY, OWNERS_AND_MANAGERS, ALL_MEMBERS, NONE
enableCollaborativeInboxstringNoWhether collaborative inbox is enabled: true or false
whoCanDiscoverGroupstringNoWho can discover: ANYONE_CAN_DISCOVER, ALL_IN_DOMAIN_CAN_DISCOVER, ALL_MEMBERS_CAN_DISCOVER
defaultSenderstringNoDefault sender: DEFAULT_SELF or GROUP

Output

ParameterTypeDescription
emailstringThe group's email address
namestringThe group name
descriptionstringThe group description
whoCanJoinstringWho can join the group
whoCanViewMembershipstringWho can view group membership
whoCanViewGroupstringWho can view group messages
whoCanPostMessagestringWho can post messages to the group
allowExternalMembersstringWhether external users can be members
allowWebPostingstringWhether web posting is allowed
primaryLanguagestringThe group's primary language
isArchivedstringWhether messages are archived
archiveOnlystringWhether the group is archive-only
messageModerationLevelstringMessage moderation level
spamModerationLevelstringSpam handling level
replyTostringDefault reply destination
customReplyTostringCustom email for replies
includeCustomFooterstringWhether to include custom footer
customFooterTextstringCustom footer text
sendMessageDenyNotificationstringWhether to send rejection notifications
defaultMessageDenyNotificationTextstringDefault rejection message text
membersCanPostAsTheGroupstringWhether members can post as the group
includeInGlobalAddressListstringWhether included in Global Address List
whoCanLeaveGroupstringWho can leave the group
whoCanContactOwnerstringWho can contact the group owner
favoriteRepliesOnTopstringWhether favorite replies appear at top
whoCanApproveMembersstringWho can approve new members
whoCanBanUsersstringWho can ban users
whoCanModerateMembersstringWho can manage members
whoCanModerateContentstringWho can moderate content
whoCanAssistContentstringWho can assist with content metadata
enableCollaborativeInboxstringWhether collaborative inbox is enabled
whoCanDiscoverGroupstringWho can discover the group
defaultSenderstringDefault sender identity

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started