API operational
All platform guides
Platform guide

Google Business Profile

Requires a Google account with owner or manager access to an open Business Profile location.

approval required1,500 characters1 media item

Capabilities at a glance

AnalyticsSupportedCommentsSupportedMessagesNot availableRemote deletionSupportedToken refreshSupported
01

Connect Google Business Profile

Create the hosted connection URL on your server. The customer completes OAuth or the provider-specific credential form directly on PostGate.

Connection requestPostGate API
curl -X POST https://postgate.studio/api/profiles/connect \
  -H "Authorization: Bearer $POSTGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "platform": "google_business",
  "profile_group_id": "grp_acme123",
  "return_url": "https://app.example.com/settings/social"
}'
02

Publish to Google Business Profile

Use the connected profile ID as the target. Provider-specific fields live under post.options.google_business so the unified envelope remains stable.

Post envelopePostGate API
{
  "post": {
    "body": "Launch day.",
    "options": {
      "google_business": {
        "topic_type": "STANDARD",
        "language_code": "en"
      }
    }
  },
  "profiles": [
    "pro_google_business123"
  ],
  "media": [
    "med_01JXYZ"
  ]
}
03

Media and content limits

PostGate validates the request at creation and again at delivery. Account-level provider limits can be narrower than the general contract.

Text1,500 characters
LinksAllowed
Mediaimages · Up to 1
Image size5 MB
Video sizeProvider default
Video durationUp to Provider default
04

Operational notes

These constraints affect approval, connection health, or delivery behavior for this provider.

  • Google Business Profile API access is required.

Check live capability before showing the option
Call GET /api/platforms. A provider appears only when it is enabled and configured for the current workspace.
Next guideBuild the complete post envelopeCompareAll platform capabilities