Skip to content
Blackbird docs

Hubspot CMS

View on Github

HubSpot CMS is a user-friendly platform designed to streamline the process of creating, managing, and optimizing digital content for websites. It offers a range of tools that allow businesses to build and customize their online presence without requiring extensive technical expertise. The platform’s intuitive drag-and-drop interface facilitates effortless content creation and editing, and it emphasizes inbound marketing strategies. This makes HubSpot CMS a valuable solution for businesses aiming to enhance their online presence, engage their audience, and drive meaningful conversions.

With multilingual content management, global content modules, and content personalization features, HubSpot CMS makes it easy to adapt digital content for different languages and regions. Now, with a seamless connection from Blackbird.io, businesses can effortlessly synchronize and manage their content, data, and marketing strategies across platforms. Achieve higher levels of operational efficiency, reduce manual efforts, and ensure consistent brand messaging across diverse markets.

Before setting up

Before you can connect you need to make sure that:

Connecting

  1. Navigate to apps and search for Hubspot (CMS). If you cannot find Hubspot (CMS) then click Add App in the top right corner, select Hubspot (CMS) and add the app to your Blackbird environment.
  2. Click Add Connection. Add Connection
  3. Name your connection for future reference e.g. ‘My organization’.
  4. Click Authorize connection.
  5. Follow the instructions that HubSpot CMS gives you, authorizing Blackbird.io to act on your behalf.
  6. When you return to Blackbird, confirm that the connection has appeared and the status is Connected. Connected

Actions

Landing & site pages

Note: the actions for landing and site pages are the same, but have separate actions for each.

A site page is a more general and versatile page on Hubspot CMS website that can contain various types of content and is part of your site’s overall navigation and structure. A landing page in HubSpot CMS is a standalone page typically designed for a specific marketing campaign, with a clear call-to-action (CTA) to capture leads.

  • Get a landing/site page Retrieve information from a specific page on your website by selecting it from a dynamic drop-down list as an input value.
  • Search landing/site pages searches for landing/site pages matching certain criteria. One of those criteria is Not translated in language which you can use to filter pages that are missing translations.
  • Get a landing/site page as HTML file Get webpage details and an HTML file of its content for easy translation and integration while preserving formatting and layout.
  • Translate a landing/site page from HTML file Create a new translation for a landing/site page based on an HTML file input. It enables seamless integration of externally translated content back into the website while maintaining the HTML structure. Note: if you are using this action with a landing/site page that has no translations yet, you need to provide the primary language.
  • Schedule a landing/site page for publishing Automate webpage publishing to release translated content at the right time for a better user experience.

Blog posts

  • Search blog posts searches for blog posts matching certain criteria. One of those criteria is Not translated in language which you can use to filter pages that are missing translations.
  • Get blog post Get blog post information.
  • Create blog post Create a new blog post. This action allows for the generation of fresh, localized content to engage global audiences and expand the reach of your blog or website, fostering international growth and user engagement.
  • Delete blog post Delete a blog post
  • Get blog post as HTML file Get blog post as HTML file.
  • Translate blog post from HTML file Translate blog post from HTML file.
  • Update blog post Update a blog post information.
  • Schedule a blog post page for publishing Automate blog post publishing to release translated content at the right time for a better user experience.

Marketing emails

Note: the Hubspot API marks these endpoints in beta stage.

  • Search marketing emails searches for marketing emails based on certain criteria.
  • Create marketing email creates a new marketing email.
  • Get marketing email content as HTML returns a marketing email as an HTML file for convenient translation.
  • Update marketing email content from HTML updates a marketing email content from a (translated) HTML file.
  • Create marketing email from HTML creates a marketing email by extracting content from an uploaded HTML file, using specific HTML tag IDs: name,subject, sendOnPublish, archived, activeDomain, language, publishDate, and businessUnitId. Where name is required.

Marketing forms

Note: the Hubspot API marks these endpoints in beta stage.

  • Search marketing forms searches for marketing forms based on certain criteria.
  • Get marketing form retrieves a marketing form.
  • Get marketing form as HTML returns a marketing form as an HTML file for convenient translation.
  • Update marketing form from HTML updates a marketing form from a (translated) HTML file.
  • Create marketing form creates a new marketing form.
  • Create marketing form from HTML create a marketing form from a HTML file content, using metadata IDs: name, type, language, archived. If there is no specific metadata, then it search for HTML tag IDs: name, type, language, archived.

Events

  • On blog posts created or updated triggers when a blog post is created or updated.
  • On landing pages created or updated triggers when a landing page is created or updated.
  • On site pages created or updated triggers when a site page is created or updated.

This events are working on polling mechanism, so you won’t be immediately notified about the changes. You can configure the polling interval starting from 5 minutes to 7 days.

Useful tips

All actions that work with HTML files will add a meta tag to the HTML. This meta tag is named blackbird-reference-id. This tag is used to identify the content in the Hubspot CMS, eliminating the need to store IDs elsewhere

Examples

Example

This example uses a polling event to check for new blog posts. When a new blog post is created, the event triggers and the blog post is translated into a different language.