Manage contact delegates

This guide covers how to create, list, and delete contact delegates.

Create a delegate

To create a delegate for a user, create a POST request containing the email address of the delegator:

POST https://admin.googleapis.com/admin/contacts/v1/users/[email protected]/delegates

In the request body, provide the email address for the delegate:

{ “email”: “delegate@example.com” }

A successful response returns an HTTP 200 status code and the new delegate's email:

{ “email”: “delegate@example.com” }

List delegates

To list delegates for a user's contacts, create a GET request containing the email address of that user:

GET https://admin.googleapis.com/admin/contacts/v1/users/[email protected]/delegates

A successful response returns an HTTP 200 status code and a list of delegate emails:

{ “email”: “delegate1@example.com” }

Delete a delegate

To delete a delegate of a user's contacts, create a DELETE request containing the email address of both the delegaor and delegate:

DELETE https://admin.googleapis.com/admin/contacts/v1/users/[email protected]/delegates/[email protected]

A successful response returns an HTTP 200 status code.