Skip to main content
POST
Finalize uploads

Authorizations

Authorization
string
header
required

Link access token for one Sandbox, Test, or Live authorization.

x-linked-account-id
string
header
required

Selects one of the authorization's linked accounts via the x-linked-account-id header.

Headers

x-linked-account-id
string
required

The linked account to use. The user must have shared it with your app. A missing account returns linked_account_required; an account outside your access returns linked_account_not_granted.

Example:

"conn_example123"

Body

application/json

JSON body with uploadIds and optional mediaIds and vaultUpload options.

JSON body for the finalize uploads endpoint.

uploadIds
string[]
required

Upload IDs returned by the start upload endpoint.

mediaIds
integer[]

Optional existing numeric Vault media IDs to include when adding finalized uploads to a Vault list.

vaultUpload
object

Optional Vault options. Include this object when you need numeric Vault media IDs.

Response

Successful response

uploadIds
string[]
required

Upload references that were finalized. Use these strings in mediaItems for posts, messages, stories, or mass messages.