Google Business Posting API
Publish updates, offers and events to Google Business Profiles, so they show on the business's Search and Maps listing.
- Update posts, offers and events
- A call-to-action button per post
- Locations connect through Google's login
- Limits and a log per key
const pk = new Postkey(process.env.POSTKEY_KEY);
await pk.posts.create({
accounts: [
"acc_gbp_314"
],
content: "We're open late this Friday for the street fair. Come say hi.",
media: [
{
type: "image",
url: "https://cdn.example.com/storefront.jpg"
}
],
googleBusiness: {
format: "update",
callToAction: {
type: "LEARN_MORE",
url: "https://example.com/street-fair"
}
}
});- Google Businesspublished
1 call · key customer_42
Your first Google Business post in three steps
- 1
Connect Google Business
Your customer signs in through Google Business's own login. You get an account ID, never a password.
- 2
Make a key
Create a key for that customer or agent, scoped to their accounts, with the caps you choose.
- 3
Post
Send the post to /v1/posts with that key. The Google Business result comes back in the response and by webhook.
Every Google Business format, one endpoint
Pick a format to see the exact request and what comes back. Options that only make sense on Google Business sit under "googleBusiness".
A short update with an image and a button, shown on the Business Profile.
1POST https://api.postkey.dev/v1/posts2Authorization: Bearer pk_cust_42_…3Content-Type: application/json4 5{6 "accounts": [7 "acc_gbp_314"8 ],9 "content": "We're open late this Friday for the street fair. Come say hi.",10 "media": [11 {12 "type": "image",13 "url": "https://cdn.example.com/storefront.jpg"14 }15 ],16 "googleBusiness": {17 "format": "update",18 "callToAction": {19 "type": "LEARN_MORE",20 "url": "https://example.com/street-fair"21 }22 }23}200 · published
Counted against customer_42 only.
{
"id": "post_3k9d2",
"status": "published",
"results": [
{
"account": "acc_gbp_314",
"platform": "googleBusiness",
"status": "published",
"format": "update",
"url": "https://business.google.com/…"
}
]
}Everything you need for Google Business posting
Checked against Google Business's rules
Before anything is sent, Postkey checks it against Google Business's published limits:
Three post types, one field
Update, offer or event: set format and the matching fields. The rest of the request stays the same.
Buttons that bring people in
Add Book, Order, Shop, Learn more, Sign up or Call to a post, the way Google shows them on the listing.
Dates checked up front
Offers and events need a full start and end. Postkey checks them before Google sees the post.
Google login
Business owners connect through Google's own login and pick their locations. You never handle a password.
Caps per key
An agent posting for hundreds of local shops can only post as much as its key allows.
Also for Google Business
Keys & control
Every Google Business post has an owner
Each customer or agent posts to Google Business through its own key: only its accounts, its own caps, its own log, and an off switch that touches nothing else.
Works with your stack
Your code
Node and Python SDKs with the same calls, or plain REST from anything that speaks HTTP.
- Node
- Python
- {}REST
No-code tools
Call the REST API from an HTTP step in n8n, Make or Zapier. Give each workflow its own key.
- n8n
- Make
- Zapier
AI agents & MCP
The MCP server lets Claude, Cursor and other agent tools post through their own key, with caps they can't change.
- MCP server
Beyond Google Business
Same request shape on every platform. Add an account ID and the post goes there too.
- X Posting APIText · Image · Video · Thread
- Instagram Posting APIFeed post · Reel · Story · Carousel
- Facebook Posting APIText · Photo · Video
- TikTok Posting APIVideo · Photo
- LinkedIn Posting APIText · Image · Document
- YouTube Posting APIVideo
- YouTube Shorts Posting APIShort
- Pinterest Posting APIPin
- You're hereGoogle Business Posting APIUpdate post · Offer · Event
Google Business posting questions
Something not here? Email hello@postkey.dev.
What can I post to Google Business?
Update posts, offers and events on a Business Profile. You pick one with the format field; the endpoint is the same.
Where do the posts show up?
On the business's profile in Google Search and Maps.
Can one account post to several locations?
Yes. Each location a user connects gets its own account ID, so you list the ones you want in the request.
Why was my post rejected?
Google reviews posts against its content policy. If it rejects one, the webhook says so in plain words.
Can I post to Google Business and Instagram together?
Yes. List both account IDs in one request. Each gets its own result.
Can I schedule Google Business posts instead?
Yes. Add scheduledFor to the same request. See the Google Business Scheduling API page for details.
Post to Google Business with a key per customer.
Get a key, connect an account, send the request above.
Free to start. Read the docs