Skip to navigation
Social MediaReview Bundles

Create a review bundle for social media drafts

View as Markdown

Create a review bundle, optionally seeding it with drafts. A review bundle groups social media drafts under a single shareable review URL so collaborators or clients can approve content before it is scheduled or published. Pass draft_ids to seed the bundle on creation, or create an empty bundle and append drafts later via addDraftsToSocialMediaReviewBundle. Draft IDs come from getSocialMediaDrafts. The response includes a linkToReview URL to share with reviewers.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
titlestringRequired<=255 characters
The title of the review bundle.
descriptionstringOptionalDefaults to
An optional description for the review bundle.
draft_idslist of stringsOptionalDefaults to []

An optional list of draft IDs to seed the bundle with on creation. Get IDs via getSocialMediaDrafts.

Response

Review bundle created
idstringOptional
Review bundle ID.
packageIdstringOptional

Same value as id (legacy key).

titlestringOptional
The title of the review bundle.
descriptionstringOptional
The description of the review bundle.
draftslist of stringsOptional
IDs of the drafts currently in the bundle.
reviewUrlstringOptionalformat: "uri"
Shareable URL where reviewers can view and approve the bundle.
linkToReviewstringOptionalformat: "uri"

Same value as reviewUrl (legacy key).