# REST Resource: users.settings.delegates

- [Resource: Delegate](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate)
  - [JSON representation](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate.SCHEMA_REPRESENTATION)
- [VerificationStatus](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus)
- [Methods](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates#METHODS_SUMMARY)

## Resource: Delegate

Settings for a 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"](https://support.google.com/mail/answer/138350) for more information about delegates.

| JSON representation |
|---|
| ``` { "delegateEmail": string, "verificationStatus": enum (`https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus`) } ``` |

| Fields ||
|---|---|
| `delegateEmail` | `string` The email address of the delegate. |
| `verificationStatus` | ``enum (`https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus`)`` Indicates whether this address has been verified and can act as a delegate for the account. Read-only. |

## VerificationStatus

Indicates whether ownership of an email address has been verified for delegation use.

| Enums ||
|---|---|
| `verificationStatusUnspecified` | Unspecified verification status. |
| `accepted` | The address can act a delegate for the account. |
| `pending` | A verification request was mailed to the address, and the owner has not yet accepted it. |
| `rejected` | A verification request was mailed to the address, and the owner rejected it. |
| `expired` | A verification request was mailed to the address, and it expired without verification. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates/create` | Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. |
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates/delete` | Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. |
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates/get` | Gets the specified delegate. |
| ### `https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.settings.delegates/list` | Lists the delegates for the specified account. |