Skip to content

Google Business Scheduling API

Queue updates, offers and events for later on any connected location, each under its own key.

  • Schedule update post, offer and event posts
  • Exact times in ISO 8601
  • Reschedule or cancel until it goes out
  • Same limits, log and webhooks as posting now
post.tsnode
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"
    }
  },
  scheduledFor: "2026-12-01T09:00:00Z"
});
  • Google Businessqueued

Queued for Dec 1, 09:00 UTC · key customer_42

Schedule your first Google Business post

  1. 1

    Connect Google Business

    Your customer signs in through Google Business's own login. You get an account ID, never a password.

  2. 2

    Make a key

    Create a key for that customer or agent, scoped to their accounts, with the caps you choose.

  3. 3

    Schedule

    Add scheduledFor to the same request. It goes to Google Business at that time, and a webhook tells you how it went.

Every Google Business format, one endpoint

Pick a format to see the exact request with a publish time 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.

RequestREST
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  "scheduledFor": "2026-12-01T09:00:00Z"24}
Response

202 · scheduled

Queued under customer_42. It goes to Google Business at the time you set.

{
  "id": "post_3k9d2",
  "status": "scheduled",
  "scheduledFor": "2026-12-01T09:00:00Z",
  "results": [
    {
      "account": "acc_gbp_314",
      "platform": "googleBusiness",
      "status": "queued",
      "format": "update"
    }
  ]
}

Everything you need for Google Business scheduling

  • Checked against Google Business's rules

    Before anything is sent, Postkey checks it against Google Business's published limits:

    Post types
    Standard update, Offer and Eventsource
    Offers and events
    Need a title plus start and end date and timesource
    Buttons on offers
    Google ignores the call-to-action on offerssource
    Media
    Fetched by Google from a public URLsource
  • One extra field

    Every Google Business format you can post now can be scheduled with scheduledFor. Nothing else changes.

  • Move or cancel

    Change the time or cancel the post with one call before it goes out.

  • Checked when queued

    Text and media are checked against Google Business's rules when you schedule, so problems show up now.

  • 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.

Also for Google Business

PostingGoogle Business Posting APIPublish updates, offers and events to Google Business Profiles, so they show on the business's Search and Maps listing.See the page

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
    Read the docs
  • 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
    Postkey with n8n
  • 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
    About the MCP server

Google Business scheduling 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.

How do I schedule a Google Business post?

Send the normal post request with scheduledFor in ISO 8601 (UTC or with an offset). You can cancel or move it until it goes out.

Schedule to Google Business with a key per customer.

Get a key, connect an account, send the request above.