Manage contact delegates

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

If you use Google Workspace, you can give other users in your domain permission to access and manage your contacts. These delegates can add and update contacts with information like names, phone numbers, and addresses.

Create a delegate

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

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 containing the email address of that user:

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 that you want to remove. You can use the List delegates method to find a specific delegate's email address.

2. Send a DELETE request containing the email address of both the delegator and the delegate:

   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.