There's a new version of the HubSpot API

Starting November 30, 2022, API keys will be sunset as an authentication method. Learn more about this change and how to migrate an API key integration to use a private app instead.

Publish, schedule or unpublish a blog post

Last updated June 17, 2020

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 API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
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.