There's a new version of the HubSpot API

Check out the new 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:

POST

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

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

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example POST URL: https://api.hubapi.com/content/api/v2/pages/352531415/publish-action?hapikey=demo Example POST body: {"action":"schedule-publish"}