Skip to main content

Google Business Accounts & Admins

Manage who can manage a Google Business Profile: the Google accounts (personal accounts, location groups, organizations) the connection can see, their admins and the admins of each location, and pending invitations. These endpoints call Google's Account Management API with the Google Business connection of the profile; no reconnection is needed.

  • Authentication: API Key — Authorization: Apikey <YOUR_API_KEY>
  • Base path: /api/uploadposts/google-business
These actions change who controls the business

Removing an admin or lowering a role takes effect at once, and inviting an admin makes Google email that person. Every write needs "confirm": true in the body; without it the answer is 400 confirmation_required explaining what would happen, and nothing is sent to Google. Every change is recorded with the Upload-Post user who asked for it (including team members acting on the account).

Not generally available yet

Every change of who manages a listing is not generally available yet: inviting, changing or removing admins, accepting or declining invitations, transferring a location and renaming an account (except with validate_only) answer 403 ownership_changes_disabled. Do them in Google Business Profile (business.google.com). Reading accounts, admins and invitations, and creating location or user groups, work today.

When they are enabled, only the owner of the Upload-Post account can make these changes: a team member acting on the account gets 403 owner_only.

Upload-Post never takes the listing away from you

A change is refused with 409 last_owner if it would remove or demote the last owner of the account or location, and with 409 connected_identity if it would remove or demote the Google account that is connected to Upload-Post. If Upload-Post cannot check which Google account is connected, the change is not sent (503 identity_check_unavailable).

If the answer is 502 google_result_unknown

Google did not confirm whether a change was applied (timeout or Google error). Upload-Post never repeats a change automatically. Do not resend it blindly: check first with the matching GET (admins, invitations or accounts) and repeat only if it is not there.

Roles (role): PRIMARY_OWNER, OWNER, MANAGER, SITE_MANAGER (Google's AdminRole).

Accounts​

List accounts — GET /accounts​

The accounts the connected Google user owns or manages, one page at a time (Google returns at most 20 per page).

ParameterTypeRequiredDescription
userstringYesProfile username with Google Business connected.
typestringNoPERSONAL, LOCATION_GROUP, USER_GROUP or ORGANIZATION.
parent_accountstringNoaccounts/{id} of an organization or user group: lists its accounts.
page_sizeintNo1–20 (default 20).
page_tokenstringNonext_page_token of the previous answer.
curl 'https://api.upload-post.com/api/uploadposts/google-business/accounts?user=agent-paris&type=LOCATION_GROUP' \
-H 'Authorization: Apikey YOUR_API_KEY'
{
"success": true,
"accounts": [
{ "name": "accounts/1234", "accountName": "Agences Dupont", "type": "LOCATION_GROUP",
"role": "OWNER", "verificationState": "VERIFIED", "vettedState": "NOT_VETTED",
"permissionLevel": "OWNER_LEVEL" }
],
"next_page_token": null,
"connected_account": "accounts/9876"
}

Read an account — GET /accounts/get?user=&account=​

account is accounts/{id} or a bare id (default: the account saved when Google Business was connected). Returns { "success": true, "account": { ...Google's Account } }.

Create a location or user group — POST /accounts​

Google can only create location groups and user groups this way (never personal accounts or organizations).

{ "user": "agent-paris", "type": "LOCATION_GROUP", "account_name": "Agences Dupont",
"primary_owner": "accounts/9876", "confirm": true }

primary_owner defaults to the connected account. Returns the new account.

Rename an account — PATCH /accounts​

Not generally available yet (see above), except validate_only. Only business accounts, and only the name. With "validate_only": true Google checks the request without changing anything (no confirm needed). account must be the account connected to the profile or the owner of one of its saved locations (404 account_not_found otherwise).

{ "user": "agent-paris", "account": "accounts/1234", "account_name": "Dupont Immobilier", "confirm": true }

Admins​

scope chooses the target: account (default; account parameter, or the connected account) or location (location_id, which must belong to the connected Google Business account). With scope=account, account can only be the account connected to the profile or the owner of one of its saved locations; any other account answers 404 account_not_found.

Inviting, changing and removing admins are not generally available yet (see above).

List admins — GET /admins​

curl 'https://api.upload-post.com/api/uploadposts/google-business/admins?user=agent-paris&scope=location&location_id=111' \
-H 'Authorization: Apikey YOUR_API_KEY'
{
"success": true,
"parent": "locations/111",
"admins": [
{ "name": "locations/111/admins/5550", "admin": "Marie Dupont", "role": "PRIMARY_OWNER" },
{ "name": "locations/111/admins/5551", "admin": "[email protected]", "role": "MANAGER",
"pendingInvitation": true }
]
}

Invite an admin — POST /admins​

Google emails the invitation; the person gets access once they accept.

FieldTypeRequiredDescription
userstringYesProfile username.
scopestringNoaccount (default) or location.
account / location_idstringNoTarget account or location (see above).
adminstringOne ofEmail of the person to invite.
admin_accountstringOne ofaccounts/{id} of a location group to invite to a location (scope=location only).
rolestringYesOWNER, MANAGER or SITE_MANAGER.
confirmbooleanYesMust be true.
{ "user": "agent-paris", "scope": "location", "location_id": "111",
"admin": "[email protected]", "role": "MANAGER", "confirm": true }

Change a role — PATCH /admins​

{ "user": "agent-paris", "admin_name": "locations/111/admins/5551", "role": "OWNER", "confirm": true }

admin_name comes from GET /admins. If the admin does not exist the answer is 404 admin_not_found; if the role is already that one, unchanged: true and nothing is sent.

Remove an admin — DELETE /admins​

{ "user": "agent-paris", "admin_name": "locations/111/admins/5551", "confirm": true }

Invitations​

Invitations the connected Google account has received. Accepting and declining are not generally available yet (see above).

List — GET /invitations?user=&account=&target_type=​

target_type (optional): ACCOUNTS_ONLY or LOCATIONS_ONLY. Each invitation has name, role, targetType and targetAccount or targetLocation (with locationName, address and, when Google knows it, placeId).

Accept or decline — POST /invitations/accept, POST /invitations/decline​

{ "user": "agent-paris", "invitation": "accounts/9876/invitations/abc123", "confirm": true }

The invitation must be pending (404 invitation_not_found otherwise).

Transfer a location — POST /locations/transfer​

Not generally available yet (403 ownership_changes_disabled, see above). Body when enabled: { "user", "location_id", "destination_account", "confirm": true }. Google only allows it when the connected user owns the location and manages the destination account.

Errors​

Statuserror_codeWhen
400confirmation_requiredThe body has no "confirm": true.
400invalid_role, invalid_admin, admin_required, invalid_admin_name, invalid_invitation, invalid_account, invalid_account_type, invalid_scope, invalid_target_type, invalid_page_size, invalid_page_token, account_name_required, account_required, invalid_jsonRequest validation, before anything reaches Google.
403ownership_changes_disabledAdmin, invitation, transfer and rename changes (not generally available yet).
403owner_onlyA team member tried an ownership change; only the account owner can.
403google_business_permission_deniedGoogle says the connected user cannot do this.
404admin_not_found, invitation_not_found, location_not_found, account_not_foundNot there, or not an account of this connection (nothing was sent).
409last_owner, connected_identityThe change would leave no owner, or cut the connected Google account off the listing.
429daily_limit_reachedDaily limit of account-management requests or changes reached.
429google_rate_limitedGoogle is limiting this account, or too many reads this minute; retry after retry_after_seconds.
502google_result_unknownGoogle did not confirm a change. Check with a GET before retrying.
502google_unreachableGoogle did not answer a read.
503gbp_feature_disabled, audit_unavailable, identity_check_unavailableTemporarily unavailable; nothing was sent.