Google Business Real-time Notifications
Get a webhook the moment something happens on a connected Google Business Profile location, instead of polling: a new review, an edited review, a photo added by a customer, an update Google suggests for the listing, a possible duplicate, or a change in who controls the profile.
Real-time notifications are not generally available yet. Until they are, GET, PUT and PATCH /api/uploadposts/google-business/notifications answer 503 with error_code: gbp_notifications_unavailable, and no Google Business event is sent to your webhooks (you can already list them in webhook_events).
How it works
- Turn notifications on for the Google account with
PUT /api/uploadposts/google-business/notifications(below). Nothing is turned on automatically when you connect Google Business. - Subscribe your webhook to the events you want by listing them in
webhook_events(account webhook or per-profile webhook). Likecomment_received, these events are opt-in: a webhook that does not list them never receives them.
| Google notification | Webhook event |
|---|---|
NEW_REVIEW | review_received |
UPDATED_REVIEW | review_updated |
NEW_CUSTOMER_MEDIA | customer_media_received |
GOOGLE_UPDATE | listing_google_update |
DUPLICATE_LOCATION | listing_duplicate |
VOICE_OF_MERCHANT_UPDATED | listing_control_changed |
Important — one setting per Google account. Google keeps a single notification setting per Google Business account. If another tool (a reviews platform, an agency dashboard...) already receives this account's notifications, turning them on in Upload-Post replaces that tool's setting and it stops receiving them. Upload-Post detects it and refuses with
409 NOTIFICATION_SETTING_IN_USEunless you send"force": true.
Get the current setting
- Method:
GET - Endpoint:
/api/uploadposts/google-business/notifications?user=my-profile
Optional account (accounts/{id}) to pick a Google account other than the one saved on the connection.
{
"success": true,
"account": "accounts/123456789",
"notification_setting": {
"name": "accounts/123456789/notificationSetting",
"notificationTypes": ["NEW_REVIEW", "UPDATED_REVIEW"]
},
"active": true,
"managed_by_upload_post": true,
"other_tool_configured": false,
"available_types": ["GOOGLE_UPDATE", "NEW_REVIEW", "UPDATED_REVIEW", "NEW_CUSTOMER_MEDIA", "DUPLICATE_LOCATION", "VOICE_OF_MERCHANT_UPDATED"],
"webhook_events": { "NEW_REVIEW": "review_received", "...": "..." }
}
When another tool owns the setting, other_tool_configured is true and notification_setting.pubsubTopic shows that tool's destination.
Turn notifications on or off
- Method:
PUT(orPATCH) - Endpoint:
/api/uploadposts/google-business/notifications
| Field | Required | Description |
|---|---|---|
user | Yes | Profile username. |
account | No | Google account (accounts/{id}); defaults to the connection's. |
enabled | No | true (default) or false. |
types | No | Google notification types to receive (table above). Default: all six. The question and answer types were retired by Google and are refused. |
confirm | Yes | Must be true: you acknowledge that this replaces any other tool's notification setting for this Google account. |
force | No | true to replace a setting that belongs to another tool. |
confirm_other_tool | No | With enabled: false and force: true on another tool's setting: true to switch that tool's notifications off too. |
curl -X PUT https://api.upload-post.com/api/uploadposts/google-business/notifications \
-H 'Authorization: Apikey YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"user": "my-profile", "types": ["NEW_REVIEW", "UPDATED_REVIEW"], "confirm": true}'
The answer repeats the setting and lists webhook_events_to_subscribe (for example ["review_received", "review_updated"]).
"enabled": false turns them off. If other Upload-Post accounts still use the same Google account's notifications, the Google setting is kept for them (google_setting_kept: true) and only your subscription is removed.
Disconnecting Google Business, deleting the profile or deleting your Upload-Post account also removes your subscription, and switches Google's setting off when no other Upload-Post account uses it.
Webhook payload
{
"event": "review_received",
"user_email": "[email protected]",
"profile_username": "my-profile",
"platform": "google_business",
"account_id": "accounts/123456789",
"notification_type": "NEW_REVIEW",
"location": { "name": "accounts/123456789/locations/222222222", "location_id": "locations/222222222" },
"review": {
"name": "accounts/123456789/locations/222222222/reviews/AbcDef",
"starRating": "FIVE",
"comment": "Great service!",
"reviewer": { "displayName": "Jane Doe", "isAnonymous": false },
"createTime": "2026-11-14T10:00:00Z"
},
"created_at": "2026-11-14T10:00:05.000000"
}
review_received/review_updatedcarry the whole review (reply to it with Reply to a Review usingreview.name). Upload-Post reads it with your own Google connection first.customer_media_receivedcarriesmedia_item, including itsattribution, which you must show as provided (see Customer photos).listing_google_update,listing_duplicateandlisting_control_changedcarry only thelocation: read the listing to see what changed.
Each event is sent once per Upload-Post account, even when several of your Google accounts manage the location. Before sending, Upload-Post checks with your Google connection that you still manage the location: if Google says you no longer have access, nothing is sent for that location. Profiles pinned to a different location of the same Google account do not receive another location's events. Google may send the same notification more than once; deliveries follow the usual retries and delivery log.
Errors
| Status | error_code | Meaning |
|---|---|---|
| 400 | confirmation_required | "confirm": true is missing (checked before the connection). |
| 400 | invalid_notification_type | Unknown or retired type. |
| 409 | NOTIFICATION_SETTING_IN_USE | Another tool receives this Google account's notifications; send "force": true to replace it. |
| 502 / 504 | outcome_unknown: true | Google did not confirm the change; read the setting before retrying. |
| 503 | gbp_notifications_unavailable | Not enabled yet (see the note above). |