Sign up for email announcements to stay updated on the latest information about the GMB API.

Manage admins for accounts and locations

In the Google My Business API, managers for business accounts and locations are referred to as admins. To find out more about how admins can manage accounts and locations, see Google My Business accounts and location groups and Manage listing details.

Admins for accounts and locations are represented by the following collections:

The resource paths for admins are as follows:

accounts/account_name/admins/admin_id
accounts/account_name/locations/locationId/admins/admin_id
You can perform the following operations:

List admins for an account or location

Lists the admins for the specified account or location.

HTTP

To list the admins for an account, send a GET request using a URL of the following form:

https://mybusiness.googleapis.com/v4/accounts/account_name/admins

To list the admins for a location, send a GET request using a URL of the following form:

https://mybusiness.googleapis.com/v4/accounts/account_name/locations/locationId/admins

Add an admin to an account or location

Invites someone to become an admin for an account or location. The invitee's email address should be associated with a Google Account. When the invitee signs in to Google My Business using their Google Account, they will be prompted to agree to the terms and conditions before they can make changes.

HTTP

To invite a user to be an admin for an account, send a POST request using a URL of the following form:

https://mybusiness.googleapis.com/v4/accounts/account_name/admins

To invite a user to be an admin for a location, send a POST request using a URL of the following form:

https://mybusiness.googleapis.com/v4/accounts/account_name/locations/locationId/admins

Use a request body of the following form when adding admins to accounts or locations:

{
  "role": "MANAGER",
  "adminName": "annedroyd@example.com"
}

Remove an admin from an account or location

Removes an admin from the specified account or location.

HTTP

To remove an admin from an account, send a DELETE request using a URL of the following form:

https://mybusiness.googleapis.com/v4/accounts/account_name/admins/admin_id

To remove an admin from a location, send a DELETE request using a URL of the following form:

https://mybusiness.googleapis.com/v4/accounts/account_name/locations/locationId/admins/admin_id