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.

Publishes or unpublishes a Page

Last updated June 17, 2020

POST /content/api/v2/pages/:page_id/publish-action

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?






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

  • "push-buffer-live" which copies the current contents of the auto-save buffer into the live object.
  • "schedule-publish" which pushes the buffer live and then sets up the content for publishing at the existing publish_date time.
  • "cancel-publish" unpublishes the selected page.
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.
page_id Used in the request URL Unique identifier for a particular blog