> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> Connect HubSpot Blogs to xpander and give agents its 50 actions: how to sign in and connect it, and which actions to hold for approval.

HTTP API connector

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to `https://api.hubapi.com/cms/v3/blogs` and carry an OAuth 2.0 token obtained with **Sign in with HubSpot** on the cloud edition, or an API key or custom header on a self-hosted installation, which offers no sign-in flow.

## What the skill can do

API connector: 50 actions, as they appear in the skill panel. 41 of them create, change or delete something in HubSpot Blogs; mark those under **These actions need approval** when you add the skill to an agent.

* **Localization service** (15): Blog Localization Attach Author To Language Group, Blog Localization Detach Author From Language Group, Blog Localization Update Author Languages, Blog Localization Attach Post To Language Group, Blog Localization Create Language Variation Of Author, Blog Localization Set Author As Primary Language, Blog Localization Create Language Variation Of Post, Blog Localization Set Post As Primary Language, Blog Localization Attach Tag To Language Group, Blog Localization Detach Post From Language Group, Blog Localization Update Post Languages, Blog Localization Detach Tag From Language Group, Blog Localization Create Language Variation Of Tag, Blog Localization Set Tag As Primary Language, and 1 more
* **Tag management** (9): Blog Tag Management Create New Blog Tag, Blog Tag Management Retrieve Multiple Blog Tags, Blog Tag Management Retrieve Paginated List Of Tags, Blog Tag Management Delete Multiple Blog Tags, Blog Tag Management Create Multiple Blog Tags, Blog Tag Management Update Multiple Blog Tags, Blog Tag Management Update Tag By Id, Blog Tag Management Delete Tag By Id, Blog Tag Management Retrieve Tag By Id
* **Post management** (8): Blog Post Management Create New Blog Post, Blog Post Management Create Multiple Blog Posts, Blog Post Management Retrieve Multiple Blog Posts, Blog Post Management Clone Blog Post, Blog Post Management Delete Multiple Blog Posts, Blog Post Management Update Multiple Blog Posts, Blog Post Management Delete Post By Id, Blog Post Management Update Post By Id
* **Author management** (7): Blog Author Management Retrieve Author By Id, Blog Author Management Retrieve Paginated List Of Authors, Blog Author Management Update Multiple Blog Authors, Blog Author Management Create New Blog Author, Blog Author Management Delete Multiple Blog Authors, Blog Author Management Create Multiple Blog Authors, Blog Author Management Retrieve Multiple Blog Authors
* **Draft management** (5): Blog Post Management Retrieve Post By Id, Blog Draft Management Retrieve Draft Version Of Post, Blog Draft Management Update Draft Version Of Post, Blog Draft Management Publish Draft Version Of Post, Blog Draft Management Reset Draft Version Of Post
* **Revision system** (4): Blog Revision Management Retrieve Specific Revision Of Post, Blog Revision Management Restore Revision As Current Live, Blog Revision Management Retrieve All Revisions Of Post, Blog Revision Management Restore Revision As New Draft
* **Scheduling service** (2): Blog Post Management Retrieve Paginated List Of Posts, Blog Scheduling Schedule Post For Publishing

## Give an agent the HubSpot skill

Once HubSpot is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **HubSpot**. Enable only the action groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](https://docs.xpander.ai/use/skills.md).

## Related Resources

* [Skills](https://docs.xpander.ai/use/skills.md)

## HubSpot Blogs: connect and authenticate

### Authentication Options

**Built-in xpander Auth**

The simplest way to connect HubSpot Blogs is by using xpander's built-in authentication:

1. In Xpander Chat, open the agent's settings and click **Add skill**.
2. Search for **HubSpot Blogs** and select it.
3. Click **Sign in with HubSpot Blogs**.
4. Choose the account you want to connect and grant xpander permission to access it.
5. HubSpot Blogs is now ready to use.

**API Access**

### Generate a HubSpot Blogs API Key

1. Log in to your [HubSpot Blogs account](https://www.hubspot.com/products/content/blog).

2. Click on **Settings** (the gear icon) in the top bar of your dashboard.

3. In the sidebar, click on **Integration**.

4. Choose **Private Apps**, then click **Create Private App**.\\

   ![Img 1](https://mintcdn.com/xpanderai-099931d1/pzRhrv6nqUySeaGz/images/connectors/hubspot-blogs/img_1.png?fit=max\&auto=format\&n=pzRhrv6nqUySeaGz\&q=85\&s=eb195be2ca57adda8198dc0e4ed25219)

5. Give your app a name, then go to the **Scopes** tab and click **Add new scope**.

6. Under the **Other** section, check the box for `content`.\\

   ![Img 2](https://mintcdn.com/xpanderai-099931d1/pzRhrv6nqUySeaGz/images/connectors/hubspot-blogs/img_2.png?fit=max\&auto=format\&n=pzRhrv6nqUySeaGz\&q=85\&s=fce028593d602cc4798a9d266b031254)

7. Click **Create App**.

8. Your access token will be available in the **Auth** tab of your newly created private app.\\

   ![Img 3](https://mintcdn.com/xpanderai-099931d1/pzRhrv6nqUySeaGz/images/connectors/hubspot-blogs/img_3.png?fit=max\&auto=format\&n=pzRhrv6nqUySeaGz\&q=85\&s=e77d8066715f497e17daab66090a5187)

### Connect HubSpot Blogs in xpander

1. In Xpander Chat, open the agent's settings and click **Add skill**.
2. Search for **HubSpot Blogs** and select it.
3. Click **Other auth options**.
4. Enter a **connection name**, e.g., "xpander-hubspot-blogs".
5. Choose **Organization** access (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](https://docs.xpander.ai/use/agents/permissions.md#whose-credential-a-shared-agent-uses).
6. Select **API Key** as the authentication method.
7. Paste the HubSpot access token into the provided field.
8. Choose **Bearer** as the **Type**.
9. Click **Connect**.

### Give an agent the HubSpot Blogs skill

Once HubSpot Blogs is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **HubSpot Blogs**. The skill panel lists the HubSpot Blogs actions by group. Enable only the groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](https://docs.xpander.ai/use/skills.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.