Synupv1
Create a key
v1Resources/Posts

Posts

Create, read, and publish social and Google Business Profile posts.

Returns posts for one location, most recently created first, with per-platform submission state and aggregate stats.

List posts

get/api/v1/posts
posts:read
Query parameters
locationIdstringrequired
The location to list posts for. Required.
platformstringoptional
Restrict results to posts submitted to this platform.
typestring (announcement | event | offer)optional
Restrict results to one post type.
statusstringoptional
Restrict results to one post status.
fromstringoptional
Only include posts created on or after this date.
tostringoptional
Only include posts created on or before this date.
searchstringoptional
Case-insensitive match against the post's name.
pageintegeroptional
Page number, starting at 1. Defaults to 1.
perPageintegeroptional
Results per page, up to 50. Defaults to 20.
Response
dataobjectoptional
rowsarray of objectoptional
The matching posts.
idstringoptional
Unique identifier for the post.
namestringoptional
Internal name/label for the post.
typestringoptional
Post type: announcement, event, or offer.
statusstringoptional
Lifecycle status of the post: draft, scheduled, active, or error.
postDatestringoptional
The post's scheduled or created date, as an ISO 8601 timestamp.
platformsarray of stringoptional
The platforms this post targets.
firstMediaUrlstringoptional
URL of the post's first media item, or null.
firstMediaTypestringoptional
Type of the post's first media item (image or video), or null.
submissionsarray of objectoptional
Per-platform submission state for this post.
platformstringoptional
The platform this row is for.
statusstringoptional
Status of this platform submission: pending, active, error, or deleted.
postLinkstringoptional
Public URL of the published post on this platform, or null.
reviewStatestringoptional
Google moderation state (processing, live, rejected), or null for other platforms.
errorMessagestringoptional
Error message if this submission failed, or null.
messagePreviewstringoptional
First 140 characters of the post's caption, or null.
viewsnumberoptional
Total view count, or null if not yet available.
clicksnumberoptional
Total click count, or null if not yet available.
errorMsgstringoptional
Error message from the first failed submission, or null.
deletedOnstringoptional
When this post was unpublished, as an ISO 8601 timestamp, or null.
totalnumberoptional
Total number of matching posts.
statsobjectoptional
Aggregate stats across the matching posts.
totalPostsnumberoptional
Number of matching posts.
totalViewsnumberoptional
Total views across the matching posts, or null.
totalClicksnumberoptional
Total clicks across the matching posts, or null.
totalEngagementnumberoptional
Total reactions, shares, and comments combined across the matching posts.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/posts
Your API key
locationId *
platform
type
status
from
to
search
page
perPage
{
  "data": {
    "rows": [
      {
        "id": "cm_post_abc123",
        "name": "Fall Special Announcement",
        "type": "announcement",
        "status": "scheduled",
        "postDate": "2026-02-10T15:00:00.000Z",
        "platforms": [
          "google",
          "facebook"
        ],
        "firstMediaUrl": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "firstMediaType": "image",
        "submissions": [
          {
            "platform": "google",
            "status": "pending",
            "postLink": null,
            "reviewState": null,
            "errorMessage": null
          },
          {
            "platform": "facebook",
            "status": "pending",
            "postLink": null,
            "reviewState": null,
            "errorMessage": null
          }
        ],
        "messagePreview": "Join us this weekend for our fall special — 20% off all services!",
        "views": null,
        "clicks": null,
        "errorMsg": null,
        "deletedOn": null
      }
    ],
    "total": 1,
    "stats": {
      "totalPosts": 12,
      "totalViews": 4300,
      "totalClicks": 210,
      "totalEngagement": 96
    }
  }
}
v1Resources/Posts/postCreate a post

Creates a post for a location or client and submits it to the selected platforms. This publishes real content: unless scheduledFor is set or draft is true, the post goes live on its target platforms immediately. A requested platform with no active connection, or a post missing a field required to go live, never fails the call — the content is saved as a draft instead; see the response schema for how that's reported.

Create a post

post/api/v1/posts
posts:write
Request body
locationIdstringoptional
The location to post to. Provide this or clientId.
clientIdstringoptional
The client to post to at brand level. Provide this or locationId.
namestringrequired
Internal name/label for the post. Required, non-empty.
postTypestring (announcement | event | offer)required
Post type. event and offer are Google-only.
platformsarray of string (google | facebook | instagram | x | linkedin | pinterest | mastodon | bluesky | threads | tiktok)required
Target platforms. At least one is required.
connectionIdsarray of stringoptional
Explicit connection ids to publish through, instead of resolving platforms to connections.
messageGooglestringoptional
Caption for Google. Required when google is selected, unless draft.
messageFacebookstringoptional
Shared social caption for every non-Google selected platform. Required unless draft.
ctaTypestring (learn_more | sign_up | order_online | book | buy | call_now)optional
Call-to-action type.
ctaUrlstringoptional
Call-to-action destination URL.
mediaUrlsarray of objectoptional
Media to attach, one entry per platform attachment.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Event or offer title. Required for a Google event/offer, unless draft.
eventStartAtstringoptional
Event or offer start time, as an ISO 8601 timestamp. Required for a Google event/offer, unless draft.
eventEndAtstringoptional
Event or offer end time, as an ISO 8601 timestamp. Must be after the start.
offerTermsstringoptional
Offer terms.
offerCouponCodestringoptional
Offer coupon code.
offerRedeemUrlstringoptional
Offer redemption URL.
scheduledForstringoptional
Publish at this future ISO 8601 timestamp instead of immediately.
draftbooleanoptional
Save without publishing. Skips required-field checks; structural checks (limits, media rules) still apply.
Response
dataobjectoptional
A requested platform with no active connection, or a required field the post needs before it can go live, never fails this call — the post is still saved. When either gap exists, status is "no_connection" or "incomplete" and the post rides underneath as post.{id,status}; on a clean publish the top-level id/status describe the post directly.
idstringoptional
Unique identifier for the post.
statusstringoptional
Lifecycle status of the post: draft, scheduled, active, or error.
missingFieldsarray of stringoptional
Fields still needed before this post can go live, if any.
missingPlatformsarray of stringoptional
Requested platforms with no active connection, if any.
scopestring (location | client)optional
Whether the connection/field gap applies at the location or client level.
postobjectoptional
The post that was created or updated.
idstringoptional
Unique identifier for the post.
statusstringoptional
Lifecycle status of the post: draft, scheduled, active, or error.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
422The request is missing a required parameter or is otherwise malformed.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/posts
Your API key
Request body*
{
  "data": {
    "id": "cm_post_abc123",
    "status": "scheduled"
  }
}
v1Resources/Posts/getGet post analytics

Returns an engagement analytics rollup — summary totals, a per-platform breakdown, trend series, and top posts — across a client's brand-level platform connections.

Get post analytics

get/api/v1/posts/analytics
posts:read
Query parameters
clientIdstringrequired
The client to roll up. Required.
fromstringoptional
Start of the reporting period. Defaults to 30 days ago.
tostringoptional
End of the reporting period. Defaults to now.
Response
dataobjectoptional
summaryobjectoptional
Engagement totals for the current period.
totalPostsnumberoptional
Number of posts in this period.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
periodDaysnumberoptional
Length of the reporting period, in days.
prevSummaryobjectoptional
Engagement totals for the immediately prior period of equal length, for delta comparison.
totalPostsnumberoptional
Number of posts in this period.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
byPlatformarray of objectoptional
Engagement totals broken down by platform for this period.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
totalPostsnumberoptional
Number of posts in this period.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
prevByPlatformarray of objectoptional
Engagement totals broken down by platform for the prior period.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
totalPostsnumberoptional
Number of posts in this period.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
trendobjectoptional
Daily view counts per platform across the period.
datesarray of stringoptional
The dates covered by this trend, as YYYY-MM-DD strings.
seriesarray of objectoptional
One entry per platform.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
valuesarray of numberoptional
One value per date in dates, in the same order.
engagementTrendobjectoptional
Daily views, reactions, shares, comments, and reach per platform across the period.
datesarray of stringoptional
The dates covered by this trend, as YYYY-MM-DD strings.
seriesarray of objectoptional
One entry per platform.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
viewsarray of numberoptional
reactionsarray of numberoptional
sharesarray of numberoptional
commentsarray of numberoptional
reacharray of numberoptional
Daily reach values, in the same order as dates.
postsTrendobjectoptional
Daily post-submission counts per platform across the period.
datesarray of stringoptional
The dates covered by this trend, as YYYY-MM-DD strings.
seriesarray of objectoptional
One entry per platform.
platformstringoptional
The platform this row is for.
labelstringoptional
Display name of the platform.
valuesarray of numberoptional
One value per date in dates, in the same order.
allPostsarray of objectoptional
The individual submissions this rollup is built from, sorted by views.
submissionIdstringoptional
Unique identifier for the platform submission.
platformstringoptional
The platform this row is for.
platformPostIdstringoptional
The platform's own id for the published post, or null.
postLinkstringoptional
Public URL of the published post on this platform, or null.
publishedAtstringoptional
When this submission was published, as an ISO 8601 timestamp, or null.
contentPreviewstringoptional
The post's name, for display.
totalViewsnumberoptional
Total views in this period.
totalReactionsnumberoptional
Total reactions in this period.
totalSharesnumberoptional
Total shares in this period.
totalCommentsnumberoptional
Total comments in this period.
totalReachnumberoptional
Total reach for this submission.
engRatenumberoptional
Engagement rate — reactions plus shares plus comments, as a percentage of views — or null if there are no views yet.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/posts/analytics
Your API key
clientId *
from
to
{
  "data": {
    "summary": {
      "totalPosts": 18,
      "totalViews": 5400,
      "totalReactions": 320,
      "totalShares": 44,
      "totalComments": 61,
      "periodDays": 30
    },
    "prevSummary": {
      "totalPosts": 14,
      "totalViews": 4100,
      "totalReactions": 260,
      "totalShares": 30,
      "totalComments": 48
    },
    "byPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 10,
        "totalViews": 3200,
        "totalReactions": 210,
        "totalShares": 30,
        "totalComments": 40
      },
      {
        "platform": "instagram",
        "label": "Instagram",
        "totalPosts": 8,
        "totalViews": 2200,
        "totalReactions": 110,
        "totalShares": 14,
        "totalComments": 21
      }
    ],
    "prevByPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 8,
        "totalViews": 2500,
        "totalReactions": 170,
        "totalShares": 20,
        "totalComments": 32
      }
    ],
    "trend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            4,
            6
          ]
        }
      ]
    },
    "engagementTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "views": [
            180,
            210
          ],
          "reactions": [
            12,
            15
          ],
          "shares": [
            2,
            3
          ],
          "comments": [
            4,
            5
          ],
          "reach": [
            900,
            1100
          ]
        }
      ]
    },
    "postsTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            1,
            2
          ]
        }
      ]
    },
    "allPosts": [
      {
        "submissionId": "cm_sub_xyz789",
        "platform": "facebook",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "publishedAt": "2026-01-16T14:00:00.000Z",
        "contentPreview": "Join us this weekend for our fall special — 20% off all services!",
        "totalViews": 890,
        "totalReactions": 42,
        "totalShares": 6,
        "totalComments": 9,
        "totalReach": 1450,
        "engRate": 0.064
      }
    ]
  }
}
v1Resources/Posts/getGet a post

Returns a single post, including its per-platform submission performance.

Get a post

get/api/v1/posts/{id}
posts:read
Query parameters
idstringrequired
The post to look up.
Response
dataobjectoptional
Additional internal fields may be present but are not part of the stable contract — rely only on the fields documented here.
idstringoptional
Unique identifier for the post.
namestringoptional
Internal name/label for the post.
typestringoptional
Post type (duplicate of postType, kept for backward compatibility).
statusstring (draft | scheduled | active | error)optional
Lifecycle status of the post: draft, scheduled, active, or error.
postTypestring (announcement | event | offer)optional
Post type: announcement, event, or offer.
clientIdstringoptional
ID of the client this post belongs to.
locationIdstringoptional
ID of the location this post belongs to, or null for a brand-level post.
locationNamestringoptional
Display name of the post's location, or null.
clientNamestringoptional
Display name of the post's client, or null.
platformsarray of stringoptional
The platforms this post targets.
messageGooglestringoptional
Caption used for Google, or null.
messageFacebookstringoptional
Shared social caption used by every non-Google platform, or null.
ctaTypestringoptional
Call-to-action type, or null.
ctaUrlstringoptional
Call-to-action URL, or null.
ctaUrlFacebookstringoptional
Facebook-specific call-to-action URL, or null.
xThreadbooleanoptional
Whether X thread mode is enabled (bypasses the 280-character limit).
ctaJsonobjectoptional
Raw per-platform call-to-action and targeting settings.
mediaUrlsarray of objectoptional
Media attached to the post, one entry per platform attachment.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Event or offer title, or null.
eventStartAtstringoptional
Event or offer start time, as an ISO 8601 timestamp, or null.
eventEndAtstringoptional
Event or offer end time, as an ISO 8601 timestamp, or null.
offerTermsstringoptional
Offer terms, or null.
offerCouponCodestringoptional
Offer coupon code, or null.
offerRedeemUrlstringoptional
Offer redemption URL, or null.
scheduledForstringoptional
When the post is scheduled to publish, as an ISO 8601 timestamp, or null to publish immediately.
createdAtstringoptional
When the post was created, as an ISO 8601 timestamp.
performancearray of objectoptional
Per-platform submission performance for this post.
submissionIdstringoptional
Unique identifier for the platform submission.
connectionIdstringoptional
ID of the connection this submission was sent through.
sitestringoptional
The platform this submission targets.
viewsnumberoptional
Total view count, or null if not yet available.
clicksnumberoptional
Total click count, or null if not yet available.
reactionsnumberoptional
Total reaction count.
sharesnumberoptional
Total share count.
commentsnumberoptional
Total comment count.
statusstringoptional
Status of this platform submission: pending, active, error, or deleted.
platformPostIdstringoptional
The platform's own id for the published post, or null.
postLinkstringoptional
Public URL of the published post on this platform, or null.
reviewStatestringoptional
Google moderation state (processing, live, rejected), or null for other platforms.
errorMessagestringoptional
Error message if this submission failed, or null.
Errors
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/posts/{id}
Your API key
id *
{
  "data": {
    "id": "cm_post_abc123",
    "name": "Fall Special Announcement",
    "type": "announcement",
    "status": "scheduled",
    "postType": "announcement",
    "clientId": "cm_client_1",
    "locationId": "cm_loc_1",
    "locationName": "Acme Dental — Downtown",
    "clientName": "Acme Dental",
    "platforms": [
      "google",
      "facebook"
    ],
    "messageGoogle": "Join us this weekend for our fall special — 20% off all services!",
    "messageFacebook": "Join us this weekend for our fall special — 20% off all services!",
    "ctaType": "learn_more",
    "ctaUrl": "https://acmedental.example.com/fall-special",
    "ctaUrlFacebook": null,
    "xThread": false,
    "ctaJson": {
      "ctaType": "learn_more",
      "ctaUrl": "https://acmedental.example.com/fall-special",
      "ctaUrlFacebook": null,
      "xThread": false
    },
    "mediaUrls": [
      {
        "url": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "platform": "facebook",
        "type": "image"
      }
    ],
    "eventTitle": null,
    "eventStartAt": null,
    "eventEndAt": null,
    "offerTerms": null,
    "offerCouponCode": null,
    "offerRedeemUrl": null,
    "scheduledFor": "2026-02-10T15:00:00.000Z",
    "createdAt": "2026-01-20T09:12:00.000Z",
    "performance": [
      {
        "submissionId": "cm_sub_xyz789",
        "connectionId": "cm_conn_1",
        "site": "facebook",
        "views": 890,
        "clicks": null,
        "reactions": 42,
        "shares": 6,
        "comments": 9,
        "status": "active",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "reviewState": null,
        "errorMessage": null
      }
    ]
  }
}
v1Resources/Posts/patchUpdate a post

Updates an editable post (draft, scheduled, error, or active) and reconciles its platform submissions to match. If the post is not scheduled and not saved as a draft, this can publish or change what's already live on its platforms.

Update a post

patch/api/v1/posts/{id}
posts:write
Query parameters
idstringrequired
The post to update.
Request body
locationIdstringoptional
The location to post to. Provide this or clientId.
clientIdstringoptional
The client to post to at brand level. Provide this or locationId.
namestringoptional
Internal name/label for the post. Required, non-empty.
postTypestring (announcement | event | offer)optional
Post type. event and offer are Google-only.
platformsarray of string (google | facebook | instagram | x | linkedin | pinterest | mastodon | bluesky | threads | tiktok)optional
Target platforms. At least one is required.
connectionIdsarray of stringoptional
Explicit connection ids to publish through, instead of resolving platforms to connections.
messageGooglestringoptional
Caption for Google. Required when google is selected, unless draft.
messageFacebookstringoptional
Shared social caption for every non-Google selected platform. Required unless draft.
ctaTypestring (learn_more | sign_up | order_online | book | buy | call_now)optional
Call-to-action type.
ctaUrlstringoptional
Call-to-action destination URL.
mediaUrlsarray of objectoptional
Media to attach, one entry per platform attachment.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Event or offer title. Required for a Google event/offer, unless draft.
eventStartAtstringoptional
Event or offer start time, as an ISO 8601 timestamp. Required for a Google event/offer, unless draft.
eventEndAtstringoptional
Event or offer end time, as an ISO 8601 timestamp. Must be after the start.
offerTermsstringoptional
Offer terms.
offerCouponCodestringoptional
Offer coupon code.
offerRedeemUrlstringoptional
Offer redemption URL.
scheduledForstringoptional
Publish at this future ISO 8601 timestamp instead of immediately.
draftbooleanoptional
Save without publishing. Skips required-field checks; structural checks (limits, media rules) still apply.
Response
dataobjectoptional
A requested platform with no active connection, or a required field the post needs before it can go live, never fails this call — the post is still saved. When either gap exists, status is "no_connection" or "incomplete" and the post rides underneath as post.{id,status}; on a clean publish the top-level id/status describe the post directly.
idstringoptional
Unique identifier for the post.
statusstringoptional
Lifecycle status of the post: draft, scheduled, active, or error.
missingFieldsarray of stringoptional
Fields still needed before this post can go live, if any.
missingPlatformsarray of stringoptional
Requested platforms with no active connection, if any.
scopestring (location | client)optional
Whether the connection/field gap applies at the location or client level.
postobjectoptional
The post that was created or updated.
idstringoptional
Unique identifier for the post.
statusstringoptional
Lifecycle status of the post: draft, scheduled, active, or error.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
422The request is missing a required parameter or is otherwise malformed.
429Too many requests. Retry after the number of seconds in the Retry-After header.
patch/api/v1/posts/{id}
Your API key
id *
Request body
{
  "data": {
    "id": "cm_post_abc123",
    "name": "Fall Special Announcement (updated)",
    "type": "announcement",
    "status": "scheduled",
    "postType": "announcement",
    "clientId": "cm_client_1",
    "locationId": "cm_loc_1",
    "platforms": [
      "google",
      "facebook"
    ],
    "messageGoogle": "Join us this weekend — now 25% off all services!",
    "messageFacebook": "Join us this weekend — now 25% off all services!",
    "ctaType": "learn_more",
    "ctaUrl": "https://acmedental.example.com/fall-special",
    "ctaUrlFacebook": null,
    "xThread": false,
    "ctaJson": {
      "ctaType": "learn_more",
      "ctaUrl": "https://acmedental.example.com/fall-special",
      "ctaUrlFacebook": null,
      "xThread": false
    },
    "mediaUrls": [
      {
        "url": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "platform": "facebook",
        "type": "image"
      }
    ],
    "eventTitle": null,
    "eventStartAt": null,
    "eventEndAt": null,
    "offerTerms": null,
    "offerCouponCode": null,
    "offerRedeemUrl": null,
    "scheduledFor": "2026-02-10T15:00:00.000Z",
    "createdAt": "2026-01-20T09:12:00.000Z",
    "performance": []
  }
}
v1Resources/Posts/deleteUnpublish and delete a post

Unpublishes a post from every platform it was submitted to — a real, immediate action that can't be undone. Only once every platform unpublish succeeds does the post also disappear from this API; if any platform fails, nothing is archived and the post stays visible so the failure can be retried. This API never permanently deletes the post record.

Unpublish and delete a post

delete/api/v1/posts/{id}
posts:write
Query parameters
idstringrequired
The post to delete.
Response
dataobjectoptional
idstringoptional
Unique identifier for the post.
okbooleanoptional
Whether every platform submission was successfully unpublished.
deletednumberoptional
Number of platform submissions successfully unpublished.
failedarray of objectoptional
Platform submissions that failed to unpublish, if any.
connectionIdstringoptional
ID of the connection whose unpublish failed.
platformstringoptional
The platform this row is for.
errorstringoptional
Error message describing why the unpublish failed.
Errors
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
delete/api/v1/posts/{id}
Your API key
id *
{
  "data": {
    "id": "cm_post_abc123",
    "ok": true,
    "deleted": 2,
    "failed": []
  }
}
v1Resources/Posts/postPublish a post now

Force-submits a draft or errored post immediately, retrying any pending or failed platform submissions. This sends real content to the post's connected platforms right now.

Publish a post now

post/api/v1/posts/{id}/publish
posts:write
Query parameters
idstringrequired
The post to publish.
Response
dataobjectoptional
retryingnumberoptional
Number of platform submissions re-queued for delivery.
Errors
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
422The request is missing a required parameter or is otherwise malformed.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/posts/{id}/publish
Your API key
id *
{
  "data": {
    "retrying": 2
  }
}