Event & offer posts

By the end of this page, you have published an event post and an offer post to Google Business Profile (googlebusiness) with platformSpecificData.topicType.

You need a connected Google Business Profile account (accountId) and the base request.

topicType picks the post type:

Step 1: publish an event post

Set topicType: "EVENT" and an event with a title and a schedule.

• startDate and endDate are { year, month, day } objects.
• startTime and endTime are optional { hours, minutes } in 24-hour time.

Zernio also accepts ISO 8601 strings for all four and converts them.

Google shows the title and schedule as the event heading in Search and Maps. A callToAction button is optional.

import Zernio from '@zernio/node';

const zernio = new Zernio();

const { data: event } = await zernio.posts.createPost({
  body: {
    content: 'Grand opening weekend: free samples and live music both days.',
    mediaItems: [{ type: 'image', url: 'https://cdn.example.com/grand-opening.jpg' }],
    platforms: [{
      platform: 'googlebusiness',
      accountId: '66b2e19d8c3f5a7e9d0b1c2d',
      platformSpecificData: {
        topicType: 'EVENT',
        event: {
          title: 'Grand Opening Weekend',
          schedule: {
            startDate: { year: 2027, month: 5, day: 15 },
            startTime: { hours: 9, minutes: 0 },
            endDate: { year: 2027, month: 5, day: 16 },
            endTime: { hours: 17, minutes: 0 }
          }
        },
        callToAction: { type: 'LEARN_MORE', url: 'https://mybusiness.com/grand-opening' }
      }
    }],
    publishNow: true
  }
});

console.log(event.post.platforms[0].platformPostUrl);

Response (201):

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "platforms": [
      {
        "platform": "googlebusiness",
        "status": "published",
        "platformPostUrl": "https://business.google.com/..."
      }
    ]
  }
}

The same schedule as ISO 8601 strings:

"schedule": {
  "startDate": "2027-05-15T00:00:00Z",
  "startTime": "2027-05-15T09:00:00Z",
  "endDate": "2027-05-16T00:00:00Z",
  "endTime": "2027-05-16T17:00:00Z"
}

The step below changes only the platforms entry of this request and returns the same response.

Step 2: publish an offer post

Set topicType: "OFFER" and an offer with any of couponCode, redeemOnlineUrl and termsConditions. Google makes all three optional; at least one is worth setting.

Add an event with a title and schedule to give the offer a heading and a validity period on Google.

{
  "platform": "googlebusiness",
  "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
  "platformSpecificData": {
    "topicType": "OFFER",
    "event": {
      "title": "Holiday Sale, 20% Off",
      "schedule": {
        "startDate": { "year": 2027, "month": 12, "day": 1 },
        "endDate": { "year": 2027, "month": 12, "day": 31 }
      }
    },
    "offer": {
      "couponCode": "HOLIDAY20",
      "redeemOnlineUrl": "https://mybusiness.com/shop",
      "termsConditions": "Valid in store and online. Cannot be combined with other offers."
    },
    "callToAction": { "type": "SHOP", "url": "https://mybusiness.com/shop" }
  }
}

If it fails

A 207 with post.status: "failed" means the post was saved but Google rejected it.

topicType: "EVENT" without an event object is the usual cause, because Google returns 400 for it:

{
  "message": "Post created but publishing failed",
  "error": "All platforms failed",
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "failed",
    "platforms": [
      {
        "platform": "googlebusiness",
        "status": "failed",
        "errorMessage": "Request contains an invalid argument."
      }
    ]
  }
}

Add the event object with title, startDate and endDate and create the post again. A failed post is terminal and is not retried.

Error handling covers the envelope.

Related

• Posts & Content Types: the base request, call-to-action buttons and edits.
• Fields, Media & Limits: the full platformSpecificData table.
• Multi-Location Posting: the same event on every location.
• Create post: every field of the request.