There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.

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.