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.

Publish, schedule or unpublish a blog post

Last updated May 31, 2023

POST /content/api/v2/blog-posts/:blog_post_id/publish-action

Method Details

HTTP Methods:

POST

Content Type:

application/json

Response Format:

N/A

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

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