There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Publishes or unpublishes a Page

Last updated May 31, 2023

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 private app access token Authorization: Bearer {token} header 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