Manage contact delegates

This guide covers how to create, list, and delete contact delegates for Google Workspace users.

Google Workspace users can give other users in their domain permission to access and manage their contacts. These delegates can add and update contacts with information such as names, phone numbers, and addresses.

Create a delegate

To create a delegate for a user, send a POST request with the delegator's email address:

POST https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/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, send a GET request with that user's email address:

GET https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates

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

{
  "delegates": [
    {
      "email": "delegate1@example.com"
    },
    {
      "email": "delegate2@example.com"
    }
  ]
}

Delete a delegate

To delete a delegate for a user's contacts, complete these steps:

  1. Identify the delegate to remove. Use the List delegates method to find a specific delegate's email address.

  2. Send a DELETE request with the delegator and delegate email addresses:

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates/delegate@example.com

A successful response returns an HTTP 200 status code.