Sign in

v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Posts

Create a post

This endpoint lets you create a post or a draft post on Google / Facebook / Instagram.

The creation of a post will not happen in real time and might take a few minutes.

A draft post can only be created by Org Admins and is not immediately published. An expiration date must be specified when creating a draft post. In order to be published, a draft needs to be updated by a BM/GM user before the expiration date.

post/posts

Request body

publishersstring[] required

List of publisher to diffuse the post

is_draftboolean

If true, the post will be created as a draft. You must then also specify an expiration_time in the body's data.

send_notificationsboolean

If true, a notification email will be sent to all BM/GM users that have access to this draft post

Example request

{
  "business_search": {
    "business__in": [
      [
        "5409c35a97bbc544d8e26737",
        "595badaef348ab6b3530033f",
        "59d53302b12ff6429f262639"
      ]
    ]
  },
  "publishers": [
    "google_my_business",
    "facebook",
    "instagram"
  ],
  "data": {
    "summary": "Wonderful post summary !",
    "title": "Great post title !",
    "schedule_time": "2050-01-01T09:00:00",
    "expiration_time": "2050-01-01T09:00:00",
    "coupon_code": "PROMO25",
    "offer_terms": "These are the conditions",
    "start_at": "2050-01-01T09:00:00",
    "end_at": "2050-01-01T09:00:00"
  }
}

Response

OK

status'success'

Request status

codenumber

Request code

messagestring

Number of post(s) created

idsstring

Id(s) of post(s) created

Example response

{
  "code": 200,
  "message": "2 posts have been created.",
  "ids": "45,46",
  "data": [
    {
      "post_id": 101,
      "business_id": "1234567890"
    },
    {
      "post_id": 102,
      "business_id": "1234567891"
    }
  ]
}