Post to Google My Business from Paperclip

Paperclip agents can publish and schedule Google Business Profile posts through Postiz. Install the Postiz skill where the agent runs, connect your Business Profile in Postiz, and the agent can post standard updates, events with dates and times, and offers with coupon codes, each with a call-to-action button.

Setup Guide Paperclip

Please make sure there is always a human in the loop.

Last updated: September 2026

Post to Google My Business in Seconds

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Paperclip:
> Post a 20% off offer to our Google
  Business Profile, valid through Sunday

Paperclip: Done! Your Google My Business post is scheduled.

Google My Business Features

📣

Business Posts

Publish standard business updates that appear on your Google Business Profile. Keep customers informed about news, products, and services.

📅

Event Promotion

Create event posts with title, start and end dates, and times. Promote workshops, sales events, grand openings, and more.

🏷️

Offers & Coupons

Share special offers with coupon codes, redemption URLs, and terms. Drive foot traffic with exclusive deals and promotions.

🔗

Call-to-Action Buttons

Add CTA buttons like Book, Order, Shop, Learn More, Sign Up, Get Offer, or Call. Drive customer actions directly from your posts.

📍

Local SEO Boost

Regular Google My Business posts improve your local search ranking. Stay active and visible in Google Maps and local search results.

⏰

Scheduled Posting

Schedule posts with precise timestamps. Plan your business updates ahead of time and maintain consistent posting frequency.

How does Paperclip post to Google My Business?

You describe what you want in plain language and Paperclip handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your GMB Integration

Ask Paperclip whether your Google My Business account is connected. It also checks which options the platform supports.

Example conversation

> Is my Google My Business account connected to Postiz?

Paperclip: Yes — your Google My Business account is connected
  and ready. Want me to post something?

Choose Your Post Type

Select the type of post: STANDARD for general updates, EVENT for promoting events with dates and times, or OFFER for sharing deals with coupon codes.

Example conversation

> Draft a Google My Business post about our new
  feature launch

Paperclip: Here's a draft for Google My Business:
  "We just shipped something big..."
  Want me to add media and schedule it?

Create Your Post

Schedule a Google My Business post with your content, post type, and optional CTA button. Posts appear on your Business Profile in Google Search and Maps.

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Paperclip: Done! Scheduled on Google My Business for
  tomorrow at 9:00 AM.

Google My Business Settings Reference

Mention any of these in plain language and Paperclip sets them for you. These are the Google My Business options it can apply to any post.

Field	Type	Required	Description
`__type`	string	Yes	Must be "gmb"
`topicType`	string	No	Post type: STANDARD, EVENT, or OFFER
`callToActionType`	string	No	CTA button: NONE, BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, GET_OFFER, CALL
`callToActionUrl`	string	No	URL for the call-to-action button
`eventTitle`	string	No	Event name (required when topicType is EVENT)
`eventStartDate`	string	No	Event start date in YYYY-MM-DD format
`eventEndDate`	string	No	Event end date in YYYY-MM-DD format
`eventStartTime`	string	No	Event start time in HH:MM format
`eventEndTime`	string	No	Event end time in HH:MM format
`offerCouponCode`	string	No	Coupon code for offer posts
`offerRedeemUrl`	string	No	URL where customers can redeem the offer
`offerTerms`	string	No	Terms and conditions for the offer

Common Configurations

Ask Paperclip for any of these common Google My Business scenarios and it applies the matching settings.

Standard Update with Learn More CTA

Just ask

> Post it with: Standard Update with Learn More CTA

Paperclip: Got it. Applying:
  topicType: STANDARD
  callToActionType: LEARN_MORE
  callToActionUrl: https://example.com/about

Event Post with Full Details

Just ask

> Post it with: Event Post with Full Details

Paperclip: Got it. Applying:
  topicType: EVENT
  eventTitle: Weekend Workshop: Getting Started
  eventStartDate: 2025-03-15
  eventEndDate: 2025-03-16
  eventStartTime: 10:00
  eventEndTime: 16:00
  callToActionType: BOOK
  callToActionUrl: https://example.com/book

Offer with Coupon Code

Just ask

> Post it with: Offer with Coupon Code

Paperclip: Got it. Applying:
  topicType: OFFER
  callToActionType: GET_OFFER
  callToActionUrl: https://example.com/deal
  offerCouponCode: SAVE20
  offerRedeemUrl: https://example.com/redeem
  offerTerms: Valid for new customers only. Expires March 31, 2025.

Simple Update with Call Button

Just ask

> Post it with: Simple Update with Call Button

Paperclip: Got it. Applying:
  topicType: STANDARD
  callToActionType: CALL

What is Paperclip?

Paperclip is an open-source orchestration framework for building “zero-human companies” by hiring and managing teams of AI agents. It handles content, social media distribution, marketing, dev, QA, and more from a single dashboard.

👥

Agent Teams

Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.

📊

Single Dashboard

Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.

⚙

Orchestration

Schedule recurring tasks with cron jobs. Paperclip can post your Google My Business updates on a schedule without you having to ask each time.

How Postiz Works with Paperclip

When you install Postiz Agent globally, Paperclip automatically discovers it by reading the bundled SKILL.md file. This file tells Paperclip what commands are available, what environment variables are needed, and how to compose Google My Business posts with the right settings.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz commands to specialized agents in your team
✓Orchestrate multi-step workflows with approval chains
✓Monitor everything from the Paperclip dashboard

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# its tool integration system
# and assigns it to agent teams

Google My Business Posting with Paperclip

Message Paperclip from any platform — it reads the Postiz skill, discovers your Google My Business integration, and handles the entire posting workflow autonomously.

📎

From Any Chat App

Paperclip assigns specialized agents to ...

Assign a task to Paperclip from its dashboard. It runs as a long-lived service on your own infrastructure, so it picks up the task, discovers your GMB account via Postiz, creates the post with the right type and CTA, and publishes it.

Paperclip

Content Agent: Drafted a post about
  the feature launch for Google My Business.

Review Agent: Approved with minor
  edits. Ready to publish.

Scheduling Agent: Found Google My Business
  integration via Postiz.
  Scheduled for tomorrow 9:00 AM.

  Post ID: abc-123
  Status: Scheduled

📎

Scheduled & Proactive

Paperclip orchestrates recurring co...

Paperclip supports scheduled heartbeats. Set up a recurring job that posts weekly business updates, promotes upcoming events, or shares rotating offers — no manual trigger needed.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft a Google My Business post
          about trending industry topics"
      - role: reviewer
        task: "Review and polish the
          draft for engagement"
      - role: publisher
        task: "Schedule via Postiz
          for today at noon"

Why Paperclip + Postiz for Google My Business

Paperclip makes Postiz a natural fit for your Google My Business workflow. The agent discovers all available commands and autonomously chains them together.

✓Multi-agent teams for quality Google My Business content — draft, review, publish
✓Single dashboard to monitor all social media automation
✓Orchestrated pipelines from content creation to publishing
✓Scheduled pipelines for hands-free daily posting
✓Cross-post to Google My Business + other platforms in a single pipeline
✓Open-source — fully customizable agent workflows

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including GMB
metadata:
  paperclip:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# GMB Settings
topicType, callToActionType,
callToActionUrl, eventTitle,
eventStartDate, eventEndDate,
eventStartTime, eventEndTime,
offerCouponCode, offerRedeemUrl,
offerTerms

Also Works with Claude Code

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, then autonomously discovers your GMB integration, determines the right post type and CTA settings, and publishes the update.

Claude Code

> Create a Google My Business event post
  for our grand opening on March 15th
  from 10am to 6pm, with a Book CTA

Claude: Done! Scheduled on Google My Business for
  tomorrow at 9:00 AM.

Google My Business + Other Platforms

Schedule the same content to Google My Business and other platforms in a single request. Each platform gets its own settings.

Example

> Post "Excited to announce our new feature!" to
  Google My Business and LinkedIn tomorrow at 9am, then schedule
  a daily tip on Google My Business every weekday at 10am

Paperclip: Done! Scheduled:
  - Google My Business + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Google My Business: Mon-Fri 10:00 AM

What can you ask Paperclip to do on Google My Business?

You assign a task in plain language and the agent translates it into Postiz calls with the right Google My Business settings. These are prompts people actually give a Paperclip agent for Google My Business.

Standard update with CTA

Ask Paperclip

> Post a Google Business update about our new
  opening hours with a Learn More button to the
  hours page, tomorrow 8am

Paperclip: topicType: STANDARD, callToActionType:
  LEARN_MORE. Scheduled for tomorrow 8:00 AM.

Event

Ask Paperclip

> Create an event post for the tasting night on
  Oct 12 from 6 to 9pm with a Book button

Paperclip: topicType: EVENT, eventTitle and dates set,
  CTA: BOOK. Ready to schedule.

Offer

Ask Paperclip

> Post a 20% off offer valid through Sunday with
  code AUTUMN20 and a redeem link

Paperclip: topicType: OFFER, offerCouponCode: AUTUMN20,
  offerRedeemUrl set. Scheduled for 9:00 AM.

What Google My Business rules should the agent follow?

Google My Business rejects posts that break its limits, so the agent needs these constraints up front. Put them in the task or in your Paperclip agent's instructions.

✓__type is gmb. topicType is STANDARD, EVENT, or OFFER; EVENT requires eventTitle plus start and end dates (YYYY-MM-DD) and optionally times (HH:MM).
✓Google Business posts are limited to 1,500 characters. Put the key message in the first 100 characters, which show in the listing preview.
✓callToActionType adds a button: BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, GET_OFFER, or CALL. All except CALL need callToActionUrl.
✓Offers can carry offerCouponCode, offerRedeemUrl, and offerTerms. Standard posts expire from the listing after a while, so schedule regular updates.

Paperclip and Google My Business: frequently asked questions

Short answers to the questions teams ask before letting a Paperclip agent post to Google My Business through Postiz.

How do I post to Google My Business from Paperclip?

Install the Postiz skill in your agent's environment with npx skills add gitroomhq/postiz-agent, set POSTIZ_API_KEY, and connect your Google Business Profile in Postiz. Then assign a task like "post our new hours with a Learn More button tomorrow at 8am" and the agent schedules it with the right topicType.

Is Google My Business the same as Google Business Profile?

Yes. Google renamed Google My Business to Google Business Profile in 2021; the listing, posts, and management features are the same product. Postiz still uses the gmb identifier in its settings, and most people still search for the old name, so both terms refer to the same connection.

Can a Paperclip agent create event and offer posts on Google?

Yes. Ask for an event and the agent sets topicType EVENT with eventTitle, start and end dates, and optional times. Ask for an offer and it sets topicType OFFER with a coupon code, redemption URL, and terms. Both can carry a call-to-action button.

Which call-to-action buttons can Postiz add to a Google post?

Postiz supports BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, GET_OFFER, and CALL, or NONE. Every button except CALL needs a callToActionUrl. Tell the agent the action you want ("a Book button to our reservations page") and it maps it to the right type and URL.

How often should Paperclip post to my Business Profile?

Standard posts rotate off the visible listing after a period, so a weekly update keeps the profile looking active in Maps and local search. Set a Paperclip heartbeat for a weekly draft, have a person approve it, and let Postiz publish at a consistent time.