v1Resources/Posts/postReturn a scheduled post to draft
Return a scheduled post to draft
Requires Social and owning-client access. Atomically returns a scheduled post to draft, clears its date and disarms failed-submission retries. Preserves destinations. Refuses the change if publishing has already claimed the post.
post
posts:write/api/v1/posts/{id}/cancelQuery parameters
idstringrequired
Response
dataobjectoptional
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.
409The post state or series prevents this action, or content checks require a person’s decision.
422The operation is invalid for this post or is blocked by content checks. A content-check refusal includes code:content_checks_failed and the report.
429Too many requests. Retry after the number of seconds in the Retry-After header.
503The post operation could not be completed.
post/api/v1/posts/{id}/cancel
Your API key
id *
{}Guides that use this resource
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.
- How to Publish Google Business Profile Posts ProgrammaticallyPublish announcements, offers and events to Google Business Profile via API, schedule them, handle the missing-connection draft, and measure post performance.
- How to Retrieve Google Business Profile Analytics via APIPull Google Business Profile analytics through an API, portfolio-wide and per location, with views, calls, direction requests and a maps-versus-search split.
- Publish a Google Business Profile Post via APIPublish an announcement, offer or event to a location's connected platforms, and handle the draft returned when a platform is not connected.