Skip to main content

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.

Not generally available yet

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​

  1. 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.
  2. Subscribe your webhook to the events you want by listing them in webhook_events (account webhook or per-profile webhook). Like comment_received, these events are opt-in: a webhook that does not list them never receives them.
Google notificationWebhook event
NEW_REVIEWreview_received
UPDATED_REVIEWreview_updated
NEW_CUSTOMER_MEDIAcustomer_media_received
GOOGLE_UPDATElisting_google_update
DUPLICATE_LOCATIONlisting_duplicate
VOICE_OF_MERCHANT_UPDATEDlisting_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_USE unless 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 (or PATCH)
  • Endpoint: /api/uploadposts/google-business/notifications
FieldRequiredDescription
userYesProfile username.
accountNoGoogle account (accounts/{id}); defaults to the connection's.
enabledNotrue (default) or false.
typesNoGoogle notification types to receive (table above). Default: all six. The question and answer types were retired by Google and are refused.
confirmYesMust be true: you acknowledge that this replaces any other tool's notification setting for this Google account.
forceNotrue to replace a setting that belongs to another tool.
confirm_other_toolNoWith 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_updated carry the whole review (reply to it with Reply to a Review using review.name). Upload-Post reads it with your own Google connection first.
  • customer_media_received carries media_item, including its attribution, which you must show as provided (see Customer photos).
  • listing_google_update, listing_duplicate and listing_control_changed carry only the location: 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​

Statuserror_codeMeaning
400confirmation_required"confirm": true is missing (checked before the connection).
400invalid_notification_typeUnknown or retired type.
409NOTIFICATION_SETTING_IN_USEAnother tool receives this Google account's notifications; send "force": true to replace it.
502 / 504outcome_unknown: trueGoogle did not confirm the change; read the setting before retrying.
503gbp_notifications_unavailableNot enabled yet (see the note above).