HubSpot#

Access HubSpot CRM via the HubSpot API with managed OAuth authentication. Manage contacts, companies, deals, pipelines, tickets, products, line items, and more.

This skill uses ClawLink for hosted connection flows and credentials so you do not need to configure HubSpot API access yourself.

Setup in 3 Steps#

Step 1: InstallStep 2: Pair AccountStep 3: Connect HubSpot_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect HubSpot

How It Works#

text

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│     HubSpot      │
│   (User Chat)   │     │   (OAuth)    │     │   (CRM API)      │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. Install Plugin    │                       │
         │  2. Pair Device       │                       │
         │  3. Connect HubSpot   │                       │
         │                       │  4. Secure Token       │
         │                       │  5. Proxy Requests    │
         │                       │                       │
         ▼                       ▼                       ▼
   ┌──────────┐           ┌──────────┐           ┌──────────┐
   │  SKILL   │           │ Dashboard│           │  HubSpot │
   │  File    │           │ Auth     │           │   CRM    │
   └──────────┘           └──────────┘           └──────────┘

Install#

Install the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.

bash

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Then tell the user: "OpenClaw has been restarted. Send /new as a standalone message to start a fresh chat, then ask for HubSpot again."

Quick Start#

bash

# List contacts
clawlink_call_tool --tool "hubspot_list_contacts" --params '{"limit": 10}'

# Search contacts
clawlink_call_tool --tool "hubspot_search_contacts" --params '{"query": "John Smith"}'

# Get a deal
clawlink_call_tool --tool "hubspot_get_deal" --params '{"deal_id": "YOUR_DEAL_ID"}'

Authentication#

All HubSpot tool calls are authenticated automatically by ClawLink using the user's connected HubSpot account.

No API key is required in chat. ClawLink stores the OAuth token securely and injects it into every HubSpot API request on the user's behalf.

Getting Connected#

1. Install the ClawLink plugin (see Install above).
2. Pair the plugin with clawlink_begin_pairing if it is not configured yet.
3. Open https://claw-link.dev/dashboard?add=hubspot and connect HubSpot.
4. Call clawlink_list_integrations to verify the connection is active.

Connection Management#

List Connections#

bash

clawlink_list_integrations

Response: Returns all connected integrations. Look for hubspot in the list.

Verify Connection#

bash

clawlink_list_tools --integration hubspot

Response: Returns the live tool catalog for HubSpot.

Reconnect#

If HubSpot tools are missing or the connection shows an error:

1. Direct the user to https://claw-link.dev/dashboard?add=hubspot
2. After they confirm, call clawlink_list_integrations to verify
3. Then call clawlink_list_tools --integration hubspot

Security & Permissions#

• Access is scoped to CRM data the connected HubSpot user has permission to view and modify.
• All write operations require explicit user confirmation. Before executing any create, update, archive, or delete call, confirm the target resource and intended effect with the user.
• Destructive actions (archive/delete contacts, deals, companies) are marked as high-impact and must be confirmed.
• Batch operations affect multiple records and should be previewed before execution.

Tool Reference#

Contacts#

ToolDescriptionModehubspot_list_contactsList all contacts with paginationReadhubspot_search_contactsSearch contacts by query or property filtersReadhubspot_get_contactGet a contact by IDReadhubspot_create_contactCreate a new contactWritehubspot_update_contactUpdate an existing contact's propertiesWritehubspot_archive_contactArchive (soft delete) a contactWritehubspot_batch_create_contactsCreate multiple contacts in one requestWritehubspot_batch_update_contactsUpdate multiple contacts in one requestWritehubspot_create_contact_from_nlCreate a contact from natural language descriptionWrite

Companies#

ToolDescriptionModehubspot_list_companiesList all companiesReadhubspot_search_companiesSearch companies by query or property filtersReadhubspot_get_companyGet a company by IDReadhubspot_create_companyCreate a new companyWritehubspot_update_companyUpdate a company's propertiesWritehubspot_archive_companyArchive a companyWritehubspot_batch_create_companiesCreate multiple companies in one requestWritehubspot_batch_update_companiesUpdate multiple companies in one requestWrite

Deals#

ToolDescriptionModehubspot_list_dealsList all deals with paginationReadhubspot_search_dealsSearch deals by query or property filtersReadhubspot_get_dealGet a deal by IDReadhubspot_create_dealCreate a new dealWritehubspot_update_dealUpdate a deal's propertiesWritehubspot_archive_dealArchive a dealWritehubspot_batch_create_dealsCreate multiple deals in one requestWritehubspot_batch_update_dealsUpdate multiple deals in one requestWritehubspot_create_deal_from_nlCreate a deal from natural language descriptionWrite

Pipelines#

ToolDescriptionModehubspot_list_pipelinesList all deal pipelinesReadhubspot_get_pipelineGet a specific pipeline's stagesReadhubspot_create_pipelineCreate a new deal pipelineWritehubspot_update_pipelineUpdate a pipeline's stages or settingsWritehubspot_delete_pipelineDelete a deal pipelineWritehubspot_audit_pipeline_changesGet audit log of pipeline changesRead

Tickets#

ToolDescriptionModehubspot_list_ticketsList all ticketsReadhubspot_search_ticketsSearch tickets by query or property filtersReadhubspot_get_ticketGet a ticket by IDReadhubspot_create_ticketCreate a new ticketWritehubspot_update_ticketUpdate a ticket's propertiesWritehubspot_archive_ticketArchive a ticketWritehubspot_batch_create_ticketsCreate multiple tickets in one requestWrite

Products & Line Items#

ToolDescriptionModehubspot_list_productsList all productsReadhubspot_get_productGet a product by IDReadhubspot_create_productCreate a new productWritehubspot_update_productUpdate a product's propertiesWritehubspot_archive_productArchive a productWritehubspot_list_line_itemsList all line itemsReadhubspot_get_line_itemGet a line item by IDReadhubspot_create_line_itemCreate a new line itemWritehubspot_update_line_itemUpdate a line item's propertiesWritehubspot_archive_line_itemArchive a line itemWrite

Associations#

ToolDescriptionModehubspot_create_associationCreate a labeled association between two CRM recordsWritehubspot_list_associationsList all associations for a recordReadhubspot_delete_associationRemove an association between two recordsWrite

Properties#

ToolDescriptionModehubspot_list_contact_propertiesList all contact propertiesReadhubspot_list_company_propertiesList all company propertiesReadhubspot_list_deal_propertiesList all deal propertiesReadhubspot_create_propertyCreate a new custom propertyWritehubspot_update_propertyUpdate a custom propertyWritehubspot_archive_propertyArchive a custom propertyWritehubspot_create_property_groupCreate a new property groupWritehubspot_update_property_groupUpdate a property groupWritehubspot_archive_property_groupArchive a property groupWrite

Quotes#

ToolDescriptionModehubspot_list_quotesList all quotesReadhubspot_get_quoteGet a quote by IDReadhubspot_create_quoteCreate a new quoteWritehubspot_update_quoteUpdate a quoteWritehubspot_archive_quoteArchive a quoteWritehubspot_batch_create_quotesCreate multiple quotes in one requestWritehubspot_batch_update_quotesUpdate multiple quotes in one requestWrite

Marketing Emails#

ToolDescriptionModehubspot_list_marketing_emailsList all marketing emailsReadhubspot_get_marketing_emailGet a marketing email by IDReadhubspot_create_marketing_emailCreate a new marketing emailWritehubspot_update_marketing_emailUpdate a marketing emailWritehubspot_clone_marketing_emailClone an existing marketing emailWritehubspot_delete_marketing_emailPermanently delete a marketing emailWritehubspot_create_draft_versionCreate or update a draft version of a marketing emailWritehubspot_get_ab_variationGet A/B test variation for a marketing emailReadhubspot_create_ab_variationCreate an A/B test variationWrite

Campaigns#

ToolDescriptionModehubspot_list_campaignsList all marketing campaignsReadhubspot_get_campaignGet a campaign by IDReadhubspot_create_campaignCreate a new marketing campaignWritehubspot_update_campaignUpdate a campaignWritehubspot_delete_campaignDelete a campaignWrite

Workflows#

ToolDescriptionModehubspot_list_workflowsList all workflowsReadhubspot_get_workflowGet a workflow by IDReadhubspot_create_workflowCreate a new workflowWritehubspot_update_workflowUpdate a workflow's settings or actionsWritehubspot_delete_workflowDelete a workflowWritehubspot_enroll_in_workflowEnroll a contact in a workflowWrite

Tasks & Notes#

ToolDescriptionModehubspot_list_tasksList all tasksReadhubspot_get_taskGet a task by IDReadhubspot_create_taskCreate a new taskWritehubspot_update_taskUpdate a taskWritehubspot_archive_taskArchive a taskWritehubspot_create_noteCreate a note on a CRM recordWrite

Engagement (Emails, Calls, Meetings)#

ToolDescriptionModehubspot_list_engagementsList all engagements (emails, calls, meetings)Readhubspot_create_engagementCreate an engagement recordWritehubspot_get_engagementGet an engagement by IDRead

Owners & Teams#

ToolDescriptionModehubspot_list_ownersList all HubSpot ownersReadhubspot_get_ownerGet a specific owner by IDReadhubspot_list_teamsList all teamsReadhubspot_get_teamGet a team by IDReadhubspot_create_teamCreate a new teamWritehubspot_update_teamUpdate a teamWritehubspot_delete_teamDelete a teamWrite

Import & Export#

ToolDescriptionModehubspot_list_importsList all import jobsReadhubspot_get_importGet status and details of an importReadhubspot_create_importCreate a new CRM import jobWritehubspot_cancel_importCancel an active importWritehubspot_fetch_import_errorsGet error details for a failed importRead

GDPR#

ToolDescriptionModehubspot_delete_contact_gdprPermanently delete a contact and associated dataWritehubspot_delete_company_gdprPermanently delete a company and associated dataWritehubspot_delete_deal_gdprArchive a deal (GDPR permanent delete not supported for deals)Write

Account & Configuration#

ToolDescriptionModehubspot_get_account_infoGet current account info (email, hub ID, user details)Readhubspot_list_ownersList all ownersRead

Code Examples#

List recent contacts#

bash

clawlink_call_tool --tool "hubspot_list_contacts" \
  --params '{
    "limit": 20,
    "properties": ["firstname", "lastname", "email", "phone"]
  }'

Search contacts by email#

bash

clawlink_call_tool --tool "hubspot_search_contacts" \
  --params '{
    "query": "john.smith@example.com"
  }'

Create a new deal#

bash

clawlink_call_tool --tool "hubspot_create_deal" \
  --params '{
    "properties": {
      "dealname": "Enterprise Contract",
      "amount": "50000",
      "dealstage": "qualifiedtobuy",
      "pipeline": "default"
    }
  }'

Create a contact from natural language#

bash

clawlink_call_tool --tool "hubspot_create_contact_from_nl" \
  --params '{
    "description": "John Smith works as CTO at Acme Corp, his email is john@acme.com and phone is 555-0100"
  }'

Create a note on a contact#

bash

clawlink_call_tool --tool "hubspot_create_note" \
  --params '{
    "engagement": {
      "active": true,
      "type": "NOTE"
    },
    "metadata": {
      "body": "Discussed Q4 renewal. Customer interested in upgrading to enterprise plan."
    },
    "associations": {
      "contact_ids": ["CONTACT_ID"]
    }
  }'

Archive a contact#

bash

clawlink_call_tool --tool "hubspot_archive_contact" \
  --params '{
    "contact_id": "YOUR_CONTACT_ID"
  }'

Discovery Workflow#

1. Call clawlink_list_integrations to confirm HubSpot is connected.
2. Call clawlink_list_tools --integration hubspot to see the live catalog.
3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.
4. If the user describes a capability but the exact tool is unclear, call clawlink_search_tools with a short query and integration hubspot.
5. If no HubSpot tools appear, direct the user to https://claw-link.dev/dashboard?add=hubspot.

Execution Workflow#

text

┌─────────────────────────────────────────────────────────────┐
│  READ OPERATIONS (Safe)                                     │
│  list → search → get → call                                 │
│                                                             │
│  Example: List contacts → Search → Get details → Show        │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  WRITE OPERATIONS (Require Confirmation)                    │
│  describe → preview → confirm → call                        │
│                                                             │
│  Example: Describe tool → Preview → User approves            │
│           → Execute create/update/archive                    │
└─────────────────────────────────────────────────────────────┘

1. For unfamiliar tools, ambiguous requests, or any write action, call clawlink_describe_tool first.
2. Use the returned guidance, schema, whenToUse, askBefore, safeDefaults, examples, and followups to shape the call.
3. Prefer read, list, search, and get operations before writes.
4. For writes or anything marked as requiring confirmation, call clawlink_preview_tool first.
5. Execute with clawlink_call_tool. Pass confirmation only after the preview matches the user's intent.
6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.

Notes#

• Contact, company, deal, and ticket IDs are stable HubSpot internal IDs — use them directly in API calls.
• Properties use internal names (e.g., dealname, amount, closedate) not display labels.
• Dates must be in ISO 8601 format (e.g., 2024-03-15).
• Batch operations support up to 100 records per request.
• create_X_from_nl tools use an LLM to parse natural language into the correct property payload.
• Archiving is a soft delete — records move to the recycling bin and can often be restored.
• GDPR permanent deletion erases contact data per compliance requirements.

Error Handling#

Status / ErrorMeaningTool not foundThe tool name does not exist in the current catalog. Verify with clawlink_list_tools --integration hubspot.Missing connectionHubSpot is not connected. Direct the user to https://claw-link.dev/dashboard?add=hubspot.RESOURCE_NOT_FOUNDRecord does not exist. Check the ID.INVALID_PROPERTY_VALUEProperty value doesn't match expected format. Check property definitions.INVALID_ARGUMENTInvalid parameter or missing required field. Review the tool schema with clawlink_describe_tool.Write rejectedUser did not confirm a write action. Always confirm before executing writes.

Troubleshooting: Tools Not Visible#

1. Check that the ClawLink plugin is installed: bash

   openclaw plugins list
   
   

2. If the plugin is installed but tools are missing, tell the user to send /new as a standalone message to reload the catalog.

3. If a fresh chat does not help, run: bash

   openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
   openclaw gateway restart
   
   

4. After restart, tell the user to send /new again and retry.

Troubleshooting: Invalid Tool Call#

1. Ensure the integration slug is exactly hubspot.
2. Use clawlink_describe_tool to verify parameter names and types before calling.
3. For write operations, always call clawlink_preview_tool first.

Resources#

• HubSpot API Documentation
• CRM API Reference
• Deals API Reference
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=hubspot-ops
• ClawLink Docs: https://docs.claw-link.dev/openclaw
• ClawLink Verification: https://claw-link.dev/verify

---

Powered by ClawLink — an integration hub for OpenClaw