Action Required: Legacy Google Contacts API will be shut down on June 15, 2021

We will be shutting down our legacy Contacts API on June 15, 2021. The Contacts API is being replaced by the new People API which has been widely adopted since its release in February 2016. The People API uses a newer JSON protocol and provides advanced features, including merging contacts with profiles.

What’s changing?

As of June 15, 2021, we will shut down the Contacts API. We strongly recommend migrating your apps to the People API.

The new People API has the same functionality as the legacy Contacts API for all features, with the following exceptions for “Other Contacts”:

  • Administrators have read-only permissions for “Other Contacts” through the new scope. As sending mutate/write signals back to “Other Contacts” is not supported, your users will have to add the Other Contact as a My Contact if they wish to update its data fields.

  • Only basic contact information for “Other Contacts” can be read through the API (for example, full name, email address, and phone number).

Additionally, the old Contacts scope ( provided access to both personal contacts and directory information.

With the People API, you will need to use the following scopes:

  • To access personal contacts -

  • To access directory information -

You can learn more in the People API documentation.

Please note that the Domain Shared Contacts API is not affected by these changes.

What do I need to do?

To ensure your applications continue to function, you must migrate all of your apps to the new People API before June 15, 2021. See our People API migration guide for detailed information on how to start leveraging the new People API.

We’re here to help

If you have additional questions or need assistance, please contact G Suite support. When you call or submit your support case, reference issue number 155939037.


The G Suite Team