---
title: "Create a post"
method: POST
path: "/posts"
tags: ["Posts"]
---

# Create a post

`POST /posts`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/posts`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/posts/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a Google Business Profile post for one or more locations.

The post shape is selected by `input.postType`. See the Announcement, Event and Offer references for the fields each type accepts.

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- object
  - `input` union, required
    - AnnouncementPostInput
      - `postName` string, required
      - `locationIds` string[], required
      - `postType` string, required
      - `postSites` string[], required
      - `postMessage` object[], required
        - `site` string
        - `message` string
    - EventPostInput
      - `postName` string, required
      - `locationIds` string[], required
      - `postType` string, required
      - `postSites` string[], required
      - `postMessage` object[], required
        - `site` string
        - `message` string
      - `postContextInfo` object, required
        - `title` string, required
        - `startDay` string, required
        - `startTime` string, required
        - `endDay` string, required
        - `endTime` string, required
    - OfferPostInput
      - `postName` string, required
      - `locationIds` string[], required
      - `postType` string, required
      - `postSites` string[], required
      - `postMessage` object[], required
        - `site` string
        - `message` string
      - `postContextInfo` object, required
        - `title` string, required
        - `couponCode` string, required
        - `redeemUrl` string, required
        - `termsConditions` string, required
        - `startDay` string, required
        - `startTime` string, required
        - `endDay` string, required
        - `endTime` string, required
      - `postCta` object[], required
        - `site` string
        - `type` string
        - `url` string

## Response `200`

- object

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)