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
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).
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.
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).
502 google_result_unknownGoogle 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).
| Parameter | Type | Required | Description |
|---|---|---|---|
user | string | Yes | Profile username with Google Business connected. |
type | string | No | PERSONAL, LOCATION_GROUP, USER_GROUP or ORGANIZATION. |
parent_account | string | No | accounts/{id} of an organization or user group: lists its accounts. |
page_size | int | No | 1–20 (default 20). |
page_token | string | No | next_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.
| Field | Type | Required | Description |
|---|---|---|---|
user | string | Yes | Profile username. |
scope | string | No | account (default) or location. |
account / location_id | string | No | Target account or location (see above). |
admin | string | One of | Email of the person to invite. |
admin_account | string | One of | accounts/{id} of a location group to invite to a location (scope=location only). |
role | string | Yes | OWNER, MANAGER or SITE_MANAGER. |
confirm | boolean | Yes | Must 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
| Status | error_code | When |
|---|---|---|
| 400 | confirmation_required | The body has no "confirm": true. |
| 400 | invalid_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_json | Request validation, before anything reaches Google. |
| 403 | ownership_changes_disabled | Admin, invitation, transfer and rename changes (not generally available yet). |
| 403 | owner_only | A team member tried an ownership change; only the account owner can. |
| 403 | google_business_permission_denied | Google says the connected user cannot do this. |
| 404 | admin_not_found, invitation_not_found, location_not_found, account_not_found | Not there, or not an account of this connection (nothing was sent). |
| 409 | last_owner, connected_identity | The change would leave no owner, or cut the connected Google account off the listing. |
| 429 | daily_limit_reached | Daily limit of account-management requests or changes reached. |
| 429 | google_rate_limited | Google is limiting this account, or too many reads this minute; retry after retry_after_seconds. |
| 502 | google_result_unknown | Google did not confirm a change. Check with a GET before retrying. |
| 502 | google_unreachable | Google did not answer a read. |
| 503 | gbp_feature_disabled, audit_unavailable, identity_check_unavailable | Temporarily unavailable; nothing was sent. |