latestOpenAPI 3.1.02026-08-13511119.5 KB

e91a4f756dfe

Posts

Create a new post

Creates a post in the specified workspace and page. Use pageId for a single post or pageIds to create grouped cross-page posts. When media URLs are provided for grouped posts, each file is imported into the workspace Media Library once and the same asset is reused across every post in the group instead of being copied per platform. The notify flag controls whether workspace members receive a post-added notification (email/in-app push); set it to false to suppress those notifications. Internal activity feed entries are always recorded. notify is not an approval request — use POST /posts/{id}/request-approval to notify approvers. The media field: Up to 20 public image or video URLs, each max 100MB. Files are downloaded server-side from the provided URLs. Use videoThumbnail to set a custom video thumbnail (cover); it requires a video in media that finishes transcoding during the request, otherwise the request returns 400 after the post is created — in that case, retry via PATCH /posts/{id} once the video is processed.

post/posts

Request body

workspaceIdstring required
pageIdstring
pageIdsstring[]
textstring
gridPositioninteger
scheduledAtstring date-time
labelsstring[]
mediastring[]

Up to 20 public image or video URLs, each max 100MB. Files are downloaded server-side from the provided URLs.

teamOnlyboolean
approvedboolean
approvedBystring
publishAtScheduledDateboolean
firstCommentstring
internalNotestring
youtubeTitlestring
linkedinPdfTitlestring

LinkedIn PDF carousel title (linkedinData.pdfTitle). When set on a LinkedIn post with multiple images, also enables publishing as a PDF document carousel (linkedinData.publishCarouselAsPdf). Pass an empty string on PATCH to disable PDF mode and clear the title.

linkedinVideoTitlestring
notifyboolean

Controls whether workspace members receive a post-added notification (email/in-app push). This is not an approval request — use POST /posts/{id}/request-approval to notify approvers.

campaignIdstring nullable

Response

Post created