There's a new version of the HubSpot API

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Publish, schedule or unpublish a blog post

Last updated May 31, 2023

POST /content/api/v2/blog-posts/:blog_post_id/publish-action

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?






Either schedules or cancels publishing based on the POSTed JSON. Publish action accepts a JSON object in this form: {"action": ..the action..} Allowable actions are:

  • "schedule-publish": sets up the content for publishing at the publish_date already set on the post.
  • "cancel-publish": cancels a previously scheduled blog post publish.

Note that this endpoint must always be used to publish a blog post. Use the Create or Update endpoints to set the publish_date, but then use this endpoint to trigger the actual publish event.

Required Parameters How to use Description
OAuth access token or private app access token Authorization: Bearer {token} header Used to authenticate the request. Please see this page for more details about authentication.
blog_post_id Used in the request URL Unique identifier for a particular blog

Returns a 204 No Content response on success, otherwise you'll get a 400 response with a message detailing the problem.