Synup
Create a key
v1Resources/Media/postPublish a media asset

Publish a media asset

Publishes an existing asset to selected Google or Facebook listings. Requires media:write and an active, identified agency user with Media access. Every target is checked before publishing. Inspect each result: HTTP 200 can include failed targets.

post/api/v1/media/{id}/publish
media:write
Query parameters
idstringrequired
The asset to share.
Request body
locationIdsarray of stringrequired
1–25 location IDs. Database and public IDs are accepted.
platformsarray of string (google | facebook)required
Google, Facebook, or both.
categorystringoptional
Optional Google media category. The asset’s category tag takes precedence.
Response
dataobjectoptional
resultsarray of objectoptional
locationIdstringoptional
platformstring (google | facebook)optional
okbooleanoptional
errorstringoptional
externalIdstringoptional
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.
422This asset cannot be published.
429Too many requests. Retry after the number of seconds in the Retry-After header.
503The media operation could not be completed.
post/api/v1/media/{id}/publish
Your API key
id *
Request body*
{}

Guides that use this resource