Managing Delegates
Stay organized with collections
Save and categorize content based on your preferences.
A Gmail user can grant mailbox access to another user in the same
Google Workspace organization. The user granting
access is referred to as the delegator
and the user receiving the access is the delegate.
Delegates can read, send, and delete messages, as well as view and add contacts,
for the delegator's account. See
Set up mail delegation
for more information about delegates.
Google Workspace organizations can use the
Delegates resource to
manage the delegates of accounts in their organization. This requires use of a
service account that has been
delegated domain-wide authority.
The Delegates reference
contains more information on how to
create,
list,
get,
or delete delegates.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[],[],null,["# Managing Delegates\n\nA Gmail user can grant mailbox access to another user in the same\nGoogle Workspace organization. The user granting\naccess is referred to as the *delegator*\nand the user receiving the access is the *delegate*.\n\nDelegates can read, send, and delete messages, as well as view and add contacts,\nfor the delegator's account. See\n[Set up mail delegation](https://support.google.com/mail/answer/138350)\nfor more information about delegates.\n\nGoogle Workspace organizations can use the\n[`Delegates`](/workspace/gmail/api/v1/reference/users/settings/delegates) resource to\nmanage the delegates of accounts in their organization. This requires use of a\n[service account](/identity/protocols/OAuth2ServiceAccount) that has been\n[delegated domain-wide authority](/identity/protocols/OAuth2ServiceAccount#delegatingauthority).\n\nThe [Delegates reference](/workspace/gmail/api/v1/reference/users/settings/delegates)\ncontains more information on how to\n[create](/workspace/gmail/api/v1/reference/users/settings/delegates/create),\n[list](/workspace/gmail/api/v1/reference/users/settings/delegates/list),\n[get](/workspace/gmail/api/v1/reference/users/settings/delegates/get),\nor [delete](/workspace/gmail/api/v1/reference/users/settings/delegates/delete) delegates."]]
