Skip to Content
ResourcesIntegrationsSalesHubSpot Marketing API

HubSpot Marketing API

HubSpot Marketing API icon
Arcade Unoptimized

Tools that enable LLMs to interact directly with the Hubspot Marketing API.

Author:Arcade
Version:0.2.1
Auth:User authorization via the Hubspot auth provider
90tools

HubSpot Marketing API Toolkit

Provides LLM access to the HubSpot Marketing API, enabling programmatic management of campaigns, emails, forms, marketing events, and transactional messaging within a HubSpot portal.

Capabilities

  • Campaign management: Create, read, update, delete, and batch-process marketing campaigns; manage campaign budgets (add, update, delete budget and spend items); retrieve attribution metrics, revenue reports, and contact-level participation data.
  • Email lifecycle: Create, clone, publish, unpublish, and delete marketing emails; manage drafts (create, update, reset, restore revisions); run A/B test variations; send template-based marketing emails and transactional emails asynchronously; query aggregated email statistics.
  • Marketing events: Full CRUD (single and batch) for marketing events; upsert single or multiple events; cancel or mark events complete; record and query contact attendance/subscriber states by HubSpot ID or email; retrieve participation counters and breakdowns; associate or disassociate lists from events.
  • Forms: Create, retrieve, list, update (full replace or partial patch), and archive HubSpot marketing forms.
  • Asset & list associations: Associate or disassociate assets (forms, static lists, external pages) with campaigns; link or unlink ILS lists with marketing events; list all assets of a given type within a campaign.
  • SMTP token management: Create, query, retrieve, reset passwords for, and delete SMTP API tokens used for transactional email delivery.

OAuth

This toolkit uses OAuth 2.0 via HubSpot. See the Arcade HubSpot auth provider docs for setup details.

Available tools(90)

90 of 90 tools
Tool nameDescriptionSecrets
Add a new budget item to a marketing campaign. Use this tool to add a budget item to an existing campaign in HubSpot Marketing. Ideal for updating campaign financials.
Delete a batch of marketing campaigns. Use this tool to delete multiple marketing campaigns in a single batch request (up to 50 campaigns). The response will indicate if the request was processed, but it won't specify the success of individual deletions. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Archive a marketing form in HubSpot. Use this tool to archive a form in HubSpot Marketing, preventing new submissions. The form will be permanently deleted after 3 months.
Associate a specified asset with a HubSpot campaign. This tool is used to link various asset types such as forms, lists, or emails with a specific HubSpot campaign. It's useful for managing and organizing marketing efforts across different platforms.
Associate a list with a marketing event by their IDs. This tool associates a specific list with a marketing event using the marketing event ID and the list ID. It is used when you need to connect a list of contacts to a marketing event for tracking and management purposes.
Cancel a HubSpot marketing event. Use this tool to mark a specific HubSpot marketing event as cancelled by providing the external event ID.
Clone an existing HubSpot marketing email. Use this tool to create a copy of an existing email in HubSpot's marketing platform. Ideal for reusing email templates and maintaining consistency in marketing campaigns.
Create a new variation for an email A/B test. Use this tool to generate a new variation of an existing email for conducting A/B tests in your marketing campaigns. This is useful for testing different email content to optimize engagement and performance.
Create a new campaign spend item for a marketing campaign. This tool creates a new spend item for a specified marketing campaign. It should be called when you need to add or track expenditures related to a specific campaign.
Create a marketing campaign and retrieve its details. This tool creates a marketing campaign using provided properties and returns the campaign object, including essential details like campaignGuid and created properties. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Create a batch of marketing campaigns in HubSpot. This tool is used to batch create up to 50 marketing campaigns in HubSpot Marketing. The campaigns in the response may not be in the same order as they were submitted in the request. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Create a new marketing email in HubSpot. Use this tool to create a new marketing email through HubSpot's marketing platform, allowing for effective email campaigns. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Create a new marketing event in HubSpot. This tool is used to create a new marketing event within the HubSpot platform. It should be called when a new event needs to be added to HubSpot's marketing event system. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Create a new marketing form in HubSpot. This tool is used to add a new form to HubSpot's marketing systems. It should be called whenever you need to create a new form for collecting marketing data. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Creates a SMTP API token for transaction emails. This tool is used to create a new SMTP API token for sending transactional emails through HubSpot's marketing service. It should be called when a new token is needed for email operations.
Delete a specific campaign budget item by ID. Use this tool to delete a specific budget item from a campaign using the campaignGuid and budgetId. Useful for managing or updating campaign budgets.
Delete a specified marketing campaign. Use this tool to delete a marketing campaign from the system by providing the campaign's GUID. A 204 No Content response is returned, indicating the request was processed, regardless of whether the campaign existed.
Delete an existing marketing email by ID. Use this tool to remove a specific marketing email from the HubSpot system by providing its unique email ID. This is useful for managing email lists and ensuring outdated or incorrect emails are removed.
Deletes a specified HubSpot marketing event. Use this tool to delete an existing marketing event in HubSpot by specifying the externalEventId. The event must have been created by the same app requesting the deletion.
Delete multiple marketing events by object ID. This tool deletes specified marketing events based on their object IDs. Use it to clean up events from the portal. It returns a status indicating whether all or only some events were successfully deleted. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Delete an SMTP token by ID in HubSpot Marketing. Use this tool to delete a specific SMTP token from HubSpot Marketing by providing the token ID. This is useful for managing and revoking access tokens when they are no longer needed or for security reasons.
Disassociate an asset from a HubSpot marketing campaign. Use this tool to remove a specified asset from a marketing campaign. Supported asset types include Forms, Static lists, and External website pages.
Disassociate a list from a marketing event using event and list IDs. Use this tool to remove the association between a specific list and a marketing event by providing the marketing event ID and the list ID. It ensures that the list is no longer linked to the specified marketing event.
Disassociate a list from a HubSpot marketing event using IDs. Use this tool to disassociate a list from a specific marketing event in HubSpot by providing the external account ID, external event ID, and list ID. This action is useful when you need to update or manage your marketing event associations.
Fetch contact IDs for a specific campaign and contact type. Use this tool to obtain the contact IDs associated with a particular marketing campaign and specified contact type in HubSpot. It is useful for analyzing campaign reach and engagement with specific contact demographics.
Page 1 of 4(25 of 90)
Last updated on