Google Business Profile API: Post an Update
How to publish a local post/update to a Google Business Profile location via API.
By André LugTo post a Google Business Profile update via API, connect a verified location the account owns or manages through OAuth, then send one POST /api/posts request with post.body, the target profile, and Google-specific fields under post.options.google_business (such as topic_type: STANDARD). Limits: 1,500 characters of text and a single JPEG or PNG image up to 5 MB — no video.
A Google Business Profile update — what Google's own API still calls a "local post" — is one POST /api/posts request through PostGate, same as any other platform. The account behind it is connected through OAuth, but the destination is a location, not a personal profile or a page, which changes a couple of things about who's allowed to publish and what a "post" means here.
The destination is a location, not an account
How do I publish a local post?
post.body and a target profiles array. Google-specific fields go under post.options.google_business.curl -X POST "https://postgate.studio/api/posts?profile_group_id=grp_acme123" \
-H "Authorization: Bearer $POSTGATE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: gbp-update-001" \
-d '{
"post": {
"body": "New seasonal menu is live in-store.",
"options": {
"google_business": { "topic_type": "STANDARD", "language_code": "en" }
}
},
"profiles": ["pro_google_business123"],
"media": ["https://cdn.example.com/menu.jpg"]
}'What does `topic_type` control?
STANDARD is the general update type and the one shown above; check the Google Business Profile platform guide for the full options.google_business schema as PostGate exposes it.Why is this platform marked “approval required”?
What are the text and media limits?
Frequently asked questions
Do I need special approval to post to Google Business Profile via API?
Google grants Business Profile publishing access per Google Cloud project through a request process, not an automatic OAuth scope grant like most other platforms. A workspace using PostGate’s shared app inherits access once that approval is in place; a workspace bringing its own Google Cloud project needs its own approval before profiles can be connected.
What post types does the Google Business Profile API support?
Beyond a plain STANDARD update, Google’s Local Posts API supports event posts with a start and end time, offer posts carrying a coupon code, and alert posts for time-sensitive notices. You pick the type with topic_type under post.options.google_business.
Can I post a video or image carousel to Google Business Profile?
No. Google’s local posts support a single image per post — JPEG or PNG, up to 5 MB — alongside up to 1,500 characters of body text. Multi-image carousels and video are not supported.
Can I manage multiple business locations through one connection?
No — the connection is per-location. Publishing requires owner or manager access to a specific, verified and open Business Profile location, so a workspace managing several locations for one business needs a connected profile for each location.
