Sign in

v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Posts

Update a post

This endpoint lets you update a post.

When used by a BM or GM user, this endpoint also serves to validate and publish a draft post.

The update will not happen in real time and might take a few minutes

⚠️ Due to Instagram API limitations, this operation has no effect on Instagram posts.

put/posts/{post_id}

Path parameters

post_idnumber required

Post id

Request body

titlestring

Title of the post.

summarystring

Main text content of the post.

cta_type'book' | 'order' | 'shop' | 'learn_more' | 'sign_up' | 'call' | 'no_cta'

The type of the post to be created. Some type mig.

schedule_timestring

Date and time of when the post will be diffused corresponding platforms. It needs to be at least 2 hours after the time of the request. The timezone used is UTC.

start_atstring

For either event or offer post type. Defined when it start. Timezone is defined by the business timezone.

end_atstring

For either event or offer post type. Defined when it end. Timezone is defined by the business timezone.

coupon_codestring

Offer code that is usable in store or online

offer_termsstring

Terms and conditions of the offer

Example request

{
  "title": "Great post title !",
  "summary": "Wonderful post summary !",
  "schedule_time": "2050-01-01T09:00:00",
  "start_at": "2050-01-01T09:00:00",
  "end_at": "2050-01-01T09:00:00",
  "coupon_code": "PROMO25",
  "offer_terms": "These are the conditions"
}

Response

OK

idinteger

The Post id

business_idstring

Business id

post_type'news' | 'event' | 'offer' | 'covid'

The type of the post to be created. Event and Offer are not yet available for Facebook.

summarystring

Main text content of the post.

schedule_timestring

Date when the Post will be published. No scheduled start time means that the Post will be published immediately.

expiration_timestring

If this post is a draft, this indicates the date when it will be expired (= date after which the BM/GM user will no longer be able to validate and publish).

validation_timestring

Date when the Draft post has been validated by the BM or GM user If the post doesn't also have a schedule time, this date coincides with the publishing date

created_atstring datetime

Creation date on Partoo

updated_atstring datetime

Last update date (either on Partoo or on Partner platform)

created_on_partooboolean

Indicates whether or not the post was created using Partoo App/API

updated_on_partooboolean

Indicates whether or not the post was updated using Partoo App/API

business_infostring

name and address of the business that the post is related to.

offer_termsstring

Terms and conditions of the offer

offer_codestring

Offer code that is usable in store or online

cta_linkstring

Link displayed in the post to redirect the client clicking on it.

cta_type'book' | 'order' | 'shop' | 'learn_more' | 'sign_up' | 'call' | 'no_cta'

The type of the post to be created. Some type mig.

Example response

{
  "id": 34,
  "business_id": "5409c35a97bbc544d8e26737",
  "summary": "Wonderful post summary !",
  "schedule_time": "2020-01-01T12:00:00+02:00",
  "expiration_time": "2020-01-01T12:00:00+02:00",
  "validation_time": "2020-01-01T12:00:00+02:00",
  "created_at": "2019-08-01T19:15:54.256000+02:00",
  "updated_at": "2019-09-01T15:12:35.256000+02:00",
  "business_info": "Rick - HQ - 157 boulevard Macdonald, Paris",
  "post_insight": [
    {
      "name": "facebook__posts",
      "click_count": 1512,
      "view_count": 2012
    }
  ],
  "post_status": [
    {
      "name": "facebook__posts",
      "state": "live",
      "link": "www.partoo.co"
    }
  ],
  "offer_terms": "These are the conditions",
  "offer_code": "PROMO25",
  "cta_link": "www.partoo.co"
}