HubSpot CMS

Integrate your Workflow with HubSpot CMS

The HubSpot CMS Integration step allows you to connect your AirOps workflows directly with your HubSpot account. This integration enables you to create, update, publish, and manage blog posts and site pages in HubSpot programmatically.

How to Configure the HubSpot CMS Integration Step

Authentication

Before using the HubSpot CMS integration in your workflows, you must first connect your HubSpot account in the AirOps Settings:

1. Navigate to ⚙ Settings > Integrations

2. Find the HubSpot CMS section and click "Configure"

3. Complete the OAuth authentication process by granting AirOps the necessary permissions

Action Types

The HubSpot CMS Integration supports the following actions:

Blog Posts

• Create Blog Post: Add a new blog post to your HubSpot blog

• Update Blog Post: Modify an existing blog post

• Get Blog Post: Retrieve a specific blog post by ID

• List Blog Posts: Retrieve a list of blog posts

• Publish Blog Post: Push a draft blog post to live

• Delete Blog Post: Remove a blog post permanently

Blog Authors

• List Blog Authors: Retrieve a list of authors from your HubSpot blog

Site Pages

• Create Site Page: Add a new page to your HubSpot site

• Update Site Page: Modify an existing site page

• Get Site Page: Retrieve a specific site page by ID

• List Site Pages: Retrieve a list of site pages

• Publish Site Page: Push a draft site page to live

• Delete Site Page: Remove a site page permanently

Action-Specific Parameters

Create Blog Post

• Internal Name: Internal name for the blog post used in the HubSpot dashboard (required)

• Page Title: The title displayed in the browser tab and search results (required)

• Blog ID: The ID of the blog this post belongs to (required)

• Post Body (Optional): The HTML body content of the blog post

• Slug (Optional): URL slug for the post (e.g. my-blog-post)

• Author Name (Optional): Display name of the post author

• Publish Date (Optional): ISO 8601 datetime to schedule publication (e.g. 2025-01-15T10:00:00Z)

Update Blog Post

• Post ID: The ID of the blog post to update (required)

• Internal Name (Optional): Updated internal name

• Page Title (Optional): Updated browser and SEO title

• Post Body (Optional): Updated HTML content

• Slug (Optional): Updated URL slug

• Author Name (Optional): Updated author display name

• Publish Date (Optional): Updated scheduled publish date

Get Blog Post

• Post ID: The ID of the blog post to retrieve (required)

List Blog Posts

• State (Optional): Filter by post state - Draft, Published, or Scheduled

• Limit (Optional): Maximum number of results to return (default 20)

Publish Blog Post

• Post ID: The ID of the draft blog post to push live (required)

Delete Blog Post

• Post ID: The ID of the blog post to delete (required)

List Blog Authors

• Limit (Optional): Maximum number of results to return

• After (Optional): Pagination cursor for fetching the next page of results

Create Site Page

• Name: Internal name for the site page (required)

• Template Path: Path to the HubSpot template to use (required)

• Page Title (Optional): SEO title for the page

• Slug (Optional): URL slug for the page (e.g. about-us)

Update Site Page

• Page ID: The ID of the site page to update (required)

• Name (Optional): Updated page name

• Page Title (Optional): Updated SEO title

• Slug (Optional): Updated URL slug

Get Site Page

• Page ID: The ID of the site page to retrieve (required)

List Site Pages

• State (Optional): Filter by page state - Draft, Published, or Scheduled

• Limit (Optional): Maximum number of results to return

• After (Optional): Pagination cursor for fetching the next page of results

Publish Site Page

• Page ID: The ID of the draft site page to push live (required)

Delete Site Page

• Page ID: The ID of the site page to delete (required)

Common Use Cases

• Generating AI-written blog posts and publishing them directly to HubSpot

• Updating existing posts with refreshed content or SEO improvements

• Scheduling content publication as part of a larger content pipeline

• Syncing content from other sources into your HubSpot CMS

Error Handling

By default, the HubSpot CMS Integration step will terminate the workflow if it fails. You can configure it to continue by selecting "Continue" instead of "Terminate Workflow" in the step settings.