schedule-gbp-postfreeStored Metrics & ReportingSchedule Post Tool
Schedule a Google Business Profile post (STANDARD, EVENT, or OFFER) for a tracked site. The post will be published to the site's connected GBP location at the specified time. Returns the full canonical scheduled-post payload so you have read-after-write within the same turn.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| site_id | integer | required | The tracked site ID. Must have an active Google Business Profile integration. |
| post_type | string | required | Post type. One of: 'STANDARD', 'EVENT', 'OFFER'. |
| summary | string | required | Post body text. Max 1500 chars. |
| scheduled_at | string | required | ISO-8601 datetime in the future when the post should publish. |
| media_url | string | optional | Optional photo URL Google should fetch for the post. |
| cta_action_type | string | optional | Optional call-to-action button: 'BOOK', 'ORDER', 'SHOP', 'LEARN_MORE', 'SIGN_UP', 'CALL'. |
| cta_url | string | optional | CTA destination URL. Pair with cta_action_type for BOOK/ORDER/SHOP/LEARN_MORE/SIGN_UP; omit for CALL (Google uses the location's phone number). |
| event | object | optional | Required for EVENT/OFFER posts. Shape: { title, schedule: { start, end } } with ISO-8601 datetimes. |
| offer | object | optional | Optional for OFFER posts. Shape: { coupon_code?, redeem_online_url?, terms? }. |
| recurrence_info | object | optional | Pass-through to Google's RecurrenceInfo if you want Google to repeat the post on a cadence. |
| pin_to_workspace_slug | string | optional | Optional workspace slug. When set, the post lands in pending_review state and a gbp_post block is created in the workspace for client/staff approval. Approve via the workspace UI to release for scheduling. |
Plan access
Available on the free tier and above. Live tools draw from your team's monthly credit budget at parity with upstream API cost (1 credit ≈ $0.001).
See plans