API Reference › integrations › hubspot

hubspot

integrations Write

Read and write the user's HubSpot CRM — contacts, companies, deals, lists, engagements, and marketing assets

Endpoint

POST https://api.adspirer.ai/api/v1/tools/hubspot/execute

Headers

Description

Read and write the user's HubSpot CRM — contacts, companies, deals, lists, engagements, and marketing assets. Use this when the user asks about: - Contacts, companies, deals, tickets, or custom CRM objects - Pushing ad leads into the CRM, or enrolling contacts in workflows/sequences - Closing the loop: which ad-sourced leads became deals or revenue - Lists, notes, tasks, meetings, email/engagement history - 'Add this lead to HubSpot', 'what deals came from my Google Ads leads', 'enroll these contacts in a sequence' This app exposes ~108 actions, so ALWAYS call `action: "list_tools"` first to get the exact action names and their parameters — do not guess a name. Some actions CREATE or UPDATE real CRM records. Confirm with the user before writing anything to their CRM. The user must have connected HubSpot in the Adspirer Connections tab. If not connected, this tool returns a connect link the user can click.

Request body

All tool arguments are wrapped in an arguments object.

FieldTypeDescription
actionstring required'list_tools': discover available actions for this app. 'execute': run a specific action by name. one of: list_tools, execute
tool_namestring optionalName of the Pipedream action to execute (required when action='execute'). Get exact names + parameters from action='list_tools' first.
argumentsobject optionalArguments object to pass to the action (required when action='execute').

Example request

{
  "arguments": {
    "action": "list_tools"
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for hubspot)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "hubspot"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "hubspot"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "hubspot",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: integrations · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai