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

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   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.

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

# 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

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

Connection Management

List Connections

clawlink_list_integrations

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

Verify Connection

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:

Direct the user to https://claw-link.dev/dashboard?add=hubspot
After they confirm, call clawlink_list_integrations to verify
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

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_contacts | List all contacts with pagination | Read | | hubspot_search_contacts | Search contacts by query or property filters | Read | | hubspot_get_contact | Get a contact by ID | Read | | hubspot_create_contact | Create a new contact | Write | | hubspot_update_contact | Update an existing contact's properties | Write | | hubspot_archive_contact | Archive (soft delete) a contact | Write | | hubspot_batch_create_contacts | Create multiple contacts in one request | Write | | hubspot_batch_update_contacts | Update multiple contacts in one request | Write | | hubspot_create_contact_from_nl | Create a contact from natural language description | Write |

Companies

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_companies | List all companies | Read | | hubspot_search_companies | Search companies by query or property filters | Read | | hubspot_get_company | Get a company by ID | Read | | hubspot_create_company | Create a new company | Write | | hubspot_update_company | Update a company's properties | Write | | hubspot_archive_company | Archive a company | Write | | hubspot_batch_create_companies | Create multiple companies in one request | Write | | hubspot_batch_update_companies | Update multiple companies in one request | Write |

Deals

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_deals | List all deals with pagination | Read | | hubspot_search_deals | Search deals by query or property filters | Read | | hubspot_get_deal | Get a deal by ID | Read | | hubspot_create_deal | Create a new deal | Write | | hubspot_update_deal | Update a deal's properties | Write | | hubspot_archive_deal | Archive a deal | Write | | hubspot_batch_create_deals | Create multiple deals in one request | Write | | hubspot_batch_update_deals | Update multiple deals in one request | Write | | hubspot_create_deal_from_nl | Create a deal from natural language description | Write |

Pipelines

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_pipelines | List all deal pipelines | Read | | hubspot_get_pipeline | Get a specific pipeline's stages | Read | | hubspot_create_pipeline | Create a new deal pipeline | Write | | hubspot_update_pipeline | Update a pipeline's stages or settings | Write | | hubspot_delete_pipeline | Delete a deal pipeline | Write | | hubspot_audit_pipeline_changes | Get audit log of pipeline changes | Read |

Tickets

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_tickets | List all tickets | Read | | hubspot_search_tickets | Search tickets by query or property filters | Read | | hubspot_get_ticket | Get a ticket by ID | Read | | hubspot_create_ticket | Create a new ticket | Write | | hubspot_update_ticket | Update a ticket's properties | Write | | hubspot_archive_ticket | Archive a ticket | Write | | hubspot_batch_create_tickets | Create multiple tickets in one request | Write |

Products & Line Items

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_products | List all products | Read | | hubspot_get_product | Get a product by ID | Read | | hubspot_create_product | Create a new product | Write | | hubspot_update_product | Update a product's properties | Write | | hubspot_archive_product | Archive a product | Write | | hubspot_list_line_items | List all line items | Read | | hubspot_get_line_item | Get a line item by ID | Read | | hubspot_create_line_item | Create a new line item | Write | | hubspot_update_line_item | Update a line item's properties | Write | | hubspot_archive_line_item | Archive a line item | Write |

Associations

| Tool | Description | Mode | |------|-------------|------| | hubspot_create_association | Create a labeled association between two CRM records | Write | | hubspot_list_associations | List all associations for a record | Read | | hubspot_delete_association | Remove an association between two records | Write |

Properties

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_contact_properties | List all contact properties | Read | | hubspot_list_company_properties | List all company properties | Read | | hubspot_list_deal_properties | List all deal properties | Read | | hubspot_create_property | Create a new custom property | Write | | hubspot_update_property | Update a custom property | Write | | hubspot_archive_property | Archive a custom property | Write | | hubspot_create_property_group | Create a new property group | Write | | hubspot_update_property_group | Update a property group | Write | | hubspot_archive_property_group | Archive a property group | Write |

Quotes

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_quotes | List all quotes | Read | | hubspot_get_quote | Get a quote by ID | Read | | hubspot_create_quote | Create a new quote | Write | | hubspot_update_quote | Update a quote | Write | | hubspot_archive_quote | Archive a quote | Write | | hubspot_batch_create_quotes | Create multiple quotes in one request | Write | | hubspot_batch_update_quotes | Update multiple quotes in one request | Write |

Marketing Emails

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_marketing_emails | List all marketing emails | Read | | hubspot_get_marketing_email | Get a marketing email by ID | Read | | hubspot_create_marketing_email | Create a new marketing email | Write | | hubspot_update_marketing_email | Update a marketing email | Write | | hubspot_clone_marketing_email | Clone an existing marketing email | Write | | hubspot_delete_marketing_email | Permanently delete a marketing email | Write | | hubspot_create_draft_version | Create or update a draft version of a marketing email | Write | | hubspot_get_ab_variation | Get A/B test variation for a marketing email | Read | | hubspot_create_ab_variation | Create an A/B test variation | Write |

Campaigns

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_campaigns | List all marketing campaigns | Read | | hubspot_get_campaign | Get a campaign by ID | Read | | hubspot_create_campaign | Create a new marketing campaign | Write | | hubspot_update_campaign | Update a campaign | Write | | hubspot_delete_campaign | Delete a campaign | Write |

Workflows

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_workflows | List all workflows | Read | | hubspot_get_workflow | Get a workflow by ID | Read | | hubspot_create_workflow | Create a new workflow | Write | | hubspot_update_workflow | Update a workflow's settings or actions | Write | | hubspot_delete_workflow | Delete a workflow | Write | | hubspot_enroll_in_workflow | Enroll a contact in a workflow | Write |

Tasks & Notes

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_tasks | List all tasks | Read | | hubspot_get_task | Get a task by ID | Read | | hubspot_create_task | Create a new task | Write | | hubspot_update_task | Update a task | Write | | hubspot_archive_task | Archive a task | Write | | hubspot_create_note | Create a note on a CRM record | Write |

Engagement (Emails, Calls, Meetings)

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_engagements | List all engagements (emails, calls, meetings) | Read | | hubspot_create_engagement | Create an engagement record | Write | | hubspot_get_engagement | Get an engagement by ID | Read |

Owners & Teams

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_owners | List all HubSpot owners | Read | | hubspot_get_owner | Get a specific owner by ID | Read | | hubspot_list_teams | List all teams | Read | | hubspot_get_team | Get a team by ID | Read | | hubspot_create_team | Create a new team | Write | | hubspot_update_team | Update a team | Write | | hubspot_delete_team | Delete a team | Write |

Import & Export

| Tool | Description | Mode | |------|-------------|------| | hubspot_list_imports | List all import jobs | Read | | hubspot_get_import | Get status and details of an import | Read | | hubspot_create_import | Create a new CRM import job | Write | | hubspot_cancel_import | Cancel an active import | Write | | hubspot_fetch_import_errors | Get error details for a failed import | Read |

GDPR

| Tool | Description | Mode | |------|-------------|------| | hubspot_delete_contact_gdpr | Permanently delete a contact and associated data | Write | | hubspot_delete_company_gdpr | Permanently delete a company and associated data | Write | | hubspot_delete_deal_gdpr | Archive a deal (GDPR permanent delete not supported for deals) | Write |

Account & Configuration

| Tool | Description | Mode | |------|-------------|------| | hubspot_get_account_info | Get current account info (email, hub ID, user details) | Read | | hubspot_list_owners | List all owners | Read |

Code Examples

List recent contacts

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

Search contacts by email

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

Create a new deal

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

Create a contact from natural language

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

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

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

Discovery Workflow

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

Execution Workflow

┌─────────────────────────────────────────────────────────────┐
│  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                    │
└─────────────────────────────────────────────────────────────┘

For unfamiliar tools, ambiguous requests, or any write action, call clawlink_describe_tool first.
Use the returned guidance, schema, whenToUse, askBefore, safeDefaults, examples, and followups to shape the call.
Prefer read, list, search, and get operations before writes.
For writes or anything marked as requiring confirmation, call clawlink_preview_tool first.
Execute with clawlink_call_tool. Pass confirmation only after the preview matches the user's intent.
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 / Error | Meaning | |----------------|---------| | Tool not found | The tool name does not exist in the current catalog. Verify with clawlink_list_tools --integration hubspot. | | Missing connection | HubSpot is not connected. Direct the user to https://claw-link.dev/dashboard?add=hubspot. | | RESOURCE_NOT_FOUND | Record does not exist. Check the ID. | | INVALID_PROPERTY_VALUE | Property value doesn't match expected format. Check property definitions. | | INVALID_ARGUMENT | Invalid parameter or missing required field. Review the tool schema with clawlink_describe_tool. | | Write rejected | User did not confirm a write action. Always confirm before executing writes. |

Troubleshooting: Tools Not Visible

Check that the ClawLink plugin is installed:
```
openclaw plugins list
```
If the plugin is installed but tools are missing, tell the user to send /new as a standalone message to reload the catalog.

If a fresh chat does not help, run:

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

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

Troubleshooting: Invalid Tool Call

Ensure the integration slug is exactly hubspot.
Use clawlink_describe_tool to verify parameter names and types before calling.
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