v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-137956179.1 KB
users

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. 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.

post/gmail/v1/users/{userId}/settings/delegates

Path parameters

userIdstring required

User's email address. The special value "me" can be used to indicate the authenticated user.

Request body

delegateEmailstring

The email address of the delegate.

verificationStatus'verificationStatusUnspecified' | 'accepted' | 'pending' | 'rejected' | 'expired'

Indicates whether this address has been verified and can act as a delegate for the account. Read-only.

Response

Successful response