Skip to main content
Version: v3

Create a new item in the queue

POST 
/social-media-posting/category/queues/:queueId/create/item

Adds a new post item to a queue. Use sessionId for edit session or directToQueue for immediate addition.

Request​

Version stringrequired

API Version

Available optionsv3
queueId stringrequired
application/json

Bodyrequired

    locationIdstringrequired

    Location ID

    sessionIdstring

    Edit session ID

    modifiedPostPayloadobject

    New post details

    orderobject

    Order for the new item in the queue (cyclic-aware). Accepts:

    • A number: explicit order value calculated by FE as midpoint between adjacent items
    • "top": place at cyclic top (first to be scheduled next)
    • "bottom": place at cyclic bottom (last to be scheduled)

    For positions between items, FE calculates: Math.floor((prevItem.order + nextItem.order) / 2) Defaults to end if not provided. Note: This field is ignored when directToQueue is true - the order will be automatically calculated based on the queue's prioritizeNewContent setting.

    variationsobject[]

    Variations

    primaryImagestring

    Primary media URL (image) for the post. Falls back to modifiedPostPayload.primaryImage if not set.

    directToQueueboolean

    When true, creates the queue item directly without requiring an edit session, even for active/paused queues. The order field is ignored and the item position is determined by the queue's prioritizeNewContent setting: if true, the item is added to the top of the queue; if false, it is added to the bottom.

application/json

Queue item created successfully.

Schema
    successbooleanrequired
    statusCodenumberrequired
    resultsobjectrequired
    traceIdstring