NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Google Admin connects to a Nagent workspace with OAuth sign-in. Once it is connected, agents can call 14 Google Admin actions, such as "Add Alias to Google Workspace User", "Add User to Google Workspace Group" and "Create Google Workspace Group". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Google Admin, with input parameters and output schema.
GOOGLE_ADMIN_ADD_USER_ALIASAdds an email alias to a Google Workspace user.
Input parameters
Alias email address to add to the user Must be unique across the entire domain; adding a duplicate alias already assigned to any user will fail.
User's primary email address or unique user ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_ADD_USER_TO_GROUPAdds a user to a Google Workspace group with the specified role.
Input parameters
Role of the user in the group (MEMBER, MANAGER, OWNER)
User's primary email address or unique user ID to add to the group
Group's email address or unique group ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_CREATE_GROUPCreates a new Google Workspace group with the specified details.
Input parameters
Display name for the group
Group's email address (will be the group ID)
Description of the group's purpose
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_CREATE_USERCreates a new Google Workspace user with the specified details. Fails if `primary_email` already exists; cannot update existing accounts.
Input parameters
User's password (must meet domain password requirements)
Whether the user account is suspended
User's first name
User's last name
Organizational unit path for the user Defaults to root OU ('/'), which applies domain-wide policies; set explicitly if per-OU policies differ.
User's primary email address
Recovery email address
Recovery phone number
Whether user must change password at next login
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_DELETE_USERDeletes a Google Workspace user permanently. This action cannot be undone.
Input parameters
User's primary email address or unique user ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_GET_GROUPRetrieves detailed information about a Google Workspace group.
Input parameters
Group's email address or unique group ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_GET_USERRetrieves detailed information about a Google Workspace user.
Input parameters
User's primary email address or unique user ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_LIST_GROUP_MEMBERSLists all members of a Google Workspace group with optional filtering and pagination.
Input parameters
Comma-separated list of roles to filter by (OWNER, MANAGER, MEMBER)
Group's email address or unique group ID
Token for retrieving next page of results
Maximum number of results to return (1-200)
Whether to include indirect memberships from nested groups
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_LIST_GROUPSLists Google Workspace groups with optional filtering and pagination.
Input parameters
Query string for filtering groups (e.g., 'name=Engineering*')
Domain name to list groups from
Customer ID or 'my_customer' for the authenticated user's customer
Property to order results by (email)
Token for retrieving next page of results
Sort order (ASCENDING or DESCENDING)
Maximum number of results to return (1-200)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_LIST_USERSLists Google Workspace users with optional filtering and pagination.
Input parameters
Query string for filtering users (e.g., 'orgName=Engineering')
Domain name to list users from (if not specified, uses the authenticated user's domain)
Customer ID or 'my_customer' for the authenticated user's customer
Property to order results by (email, givenName, familyName)
Token for retrieving next page of results
Sort order (ASCENDING or DESCENDING)
Maximum number of results to return (1-500)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_REMOVE_USER_ALIASRemoves an email alias from a Google Workspace user.
Input parameters
Alias email address to remove from the user
User's primary email address or unique user ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_REMOVE_USER_FROM_GROUPRemoves a user from a Google Workspace group, revoking their group access.
Input parameters
User's primary email address or unique user ID to remove from the group
Group's email address or unique group ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_SUSPEND_USERSuspends or unsuspends a Google Workspace user account.
Input parameters
User's primary email address or unique user ID
Whether to suspend (True) or unsuspend (False) the user
Reason for suspension (optional)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
GOOGLE_ADMIN_UPDATE_GROUP_SETTINGSUpdates settings for a Google Workspace group.
Input parameters
Updated display name for the group
Group's email address or unique group ID
Updated group description
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 14 Google Admin actions on Nagent, including "Add Alias to Google Workspace User", "Add User to Google Workspace Group" and "Create Google Workspace Group". Add Alias to Google Workspace User: Adds an email alias to a Google Workspace user. Each action is listed on this page with its input parameters and its output.
Google Admin connects with OAuth sign-in, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Add Alias to Google Workspace User takes 2 required inputs: alias and user_key. It returns data, error and successful.