Skip to content

Integrations

Google resource: gmail users settings delegates (2026-10-27)

4 Google SDK operations with complete input and response references.

Get started · Contract 2026-10-27

OperationTypeScriptPython
Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. The delegate user must be a member of the same Google Workspace organization as the delegator user. For more information, see [Manage delegates](https://developers.google.com/workspace/gmail/api/guides/delegate_settings). Gmail imposes limitations on the number of delegates and delegators each user in a Google Workspace organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators. A delegate user must be referred to by their primary email address, and not an email alias. When a new delegate is created, there may be up to a one minute delay before the new delegate is available for use. This method is only available to service account clients that have been delegated domain-wide authority.gmailUsersSettingsDelegates.gmailUsersSettingsDelegatesCreategmail_users_settings_delegates.gmail_users_settings_delegates_create
Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. For more information, see [Manage delegates](https://developers.google.com/workspace/gmail/api/guides/delegate_settings). A delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.gmailUsersSettingsDelegates.gmailUsersSettingsDelegatesDeletegmail_users_settings_delegates.gmail_users_settings_delegates_delete
Gets the specified delegate. For more information, see [Manage delegates](https://developers.google.com/workspace/gmail/api/guides/delegate_settings). A delegate user must be referred to by their primary email address, and not an email alias. This method is only available to service account clients that have been delegated domain-wide authority.gmailUsersSettingsDelegates.gmailUsersSettingsDelegatesGetgmail_users_settings_delegates.gmail_users_settings_delegates_get
Lists the delegates for the specified account. For more information, see [Manage delegates](https://developers.google.com/workspace/gmail/api/guides/delegate_settings). This method is only available to service account clients that have been delegated domain-wide authority.gmailUsersSettingsDelegates.gmailUsersSettingsDelegatesListgmail_users_settings_delegates.gmail_users_settings_delegates_list

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.