{"skill":{"slug":"hubspot-ops","displayName":"HubSpot","summary":"HubSpot CRM API integration with managed OAuth. Manage contacts, companies, deals, pipelines, tickets, products, line items, marketing emails, and workflows....","description":"---\nname: hubspot-ops\ndescription: HubSpot CRM API integration with managed OAuth. Manage contacts, companies, deals, pipelines, tickets, products, line items, marketing emails, and workflows. Use this skill when users want to work with HubSpot CRM data or automate sales and marketing operations.\n---\n\n# HubSpot\n\n![HubSpot](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/hubspot.svg)\n\nAccess HubSpot CRM via the HubSpot API with managed OAuth authentication. Manage contacts, companies, deals, pipelines, tickets, products, line items, and more.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=hubspot-ops) for hosted connection flows and credentials so you do not need to configure HubSpot API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect HubSpot |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect HubSpot |\n\n## How It Works\n\n```\n┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│     HubSpot      │\n│   (User Chat)   │     │   (OAuth)    │     │   (CRM API)      │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect HubSpot   │                       │\n         │                       │  4. Secure Token       │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │  HubSpot │\n   │  File    │           │ Auth     │           │   CRM    │\n   └──────────┘           └──────────┘           └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for HubSpot again.\"\n\n## Quick Start\n\n```bash\n# List contacts\nclawlink_call_tool --tool \"hubspot_list_contacts\" --params '{\"limit\": 10}'\n\n# Search contacts\nclawlink_call_tool --tool \"hubspot_search_contacts\" --params '{\"query\": \"John Smith\"}'\n\n# Get a deal\nclawlink_call_tool --tool \"hubspot_get_deal\" --params '{\"deal_id\": \"YOUR_DEAL_ID\"}'\n```\n\n## Authentication\n\nAll HubSpot tool calls are authenticated automatically by ClawLink using the user's connected HubSpot account.\n\n**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.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=hubspot and connect HubSpot.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `hubspot` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration hubspot\n```\n\n**Response:** Returns the live tool catalog for HubSpot.\n\n### Reconnect\n\nIf HubSpot tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=hubspot\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration hubspot`\n\n## Security & Permissions\n\n- Access is scoped to CRM data the connected HubSpot user has permission to view and modify.\n- **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.\n- Destructive actions (archive/delete contacts, deals, companies) are marked as high-impact and must be confirmed.\n- Batch operations affect multiple records and should be previewed before execution.\n\n## Tool Reference\n\n### Contacts\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_contacts` | List all contacts with pagination | Read |\n| `hubspot_search_contacts` | Search contacts by query or property filters | Read |\n| `hubspot_get_contact` | Get a contact by ID | Read |\n| `hubspot_create_contact` | Create a new contact | Write |\n| `hubspot_update_contact` | Update an existing contact's properties | Write |\n| `hubspot_archive_contact` | Archive (soft delete) a contact | Write |\n| `hubspot_batch_create_contacts` | Create multiple contacts in one request | Write |\n| `hubspot_batch_update_contacts` | Update multiple contacts in one request | Write |\n| `hubspot_create_contact_from_nl` | Create a contact from natural language description | Write |\n\n### Companies\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_companies` | List all companies | Read |\n| `hubspot_search_companies` | Search companies by query or property filters | Read |\n| `hubspot_get_company` | Get a company by ID | Read |\n| `hubspot_create_company` | Create a new company | Write |\n| `hubspot_update_company` | Update a company's properties | Write |\n| `hubspot_archive_company` | Archive a company | Write |\n| `hubspot_batch_create_companies` | Create multiple companies in one request | Write |\n| `hubspot_batch_update_companies` | Update multiple companies in one request | Write |\n\n### Deals\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_deals` | List all deals with pagination | Read |\n| `hubspot_search_deals` | Search deals by query or property filters | Read |\n| `hubspot_get_deal` | Get a deal by ID | Read |\n| `hubspot_create_deal` | Create a new deal | Write |\n| `hubspot_update_deal` | Update a deal's properties | Write |\n| `hubspot_archive_deal` | Archive a deal | Write |\n| `hubspot_batch_create_deals` | Create multiple deals in one request | Write |\n| `hubspot_batch_update_deals` | Update multiple deals in one request | Write |\n| `hubspot_create_deal_from_nl` | Create a deal from natural language description | Write |\n\n### Pipelines\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_pipelines` | List all deal pipelines | Read |\n| `hubspot_get_pipeline` | Get a specific pipeline's stages | Read |\n| `hubspot_create_pipeline` | Create a new deal pipeline | Write |\n| `hubspot_update_pipeline` | Update a pipeline's stages or settings | Write |\n| `hubspot_delete_pipeline` | Delete a deal pipeline | Write |\n| `hubspot_audit_pipeline_changes` | Get audit log of pipeline changes | Read |\n\n### Tickets\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_tickets` | List all tickets | Read |\n| `hubspot_search_tickets` | Search tickets by query or property filters | Read |\n| `hubspot_get_ticket` | Get a ticket by ID | Read |\n| `hubspot_create_ticket` | Create a new ticket | Write |\n| `hubspot_update_ticket` | Update a ticket's properties | Write |\n| `hubspot_archive_ticket` | Archive a ticket | Write |\n| `hubspot_batch_create_tickets` | Create multiple tickets in one request | Write |\n\n### Products & Line Items\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_products` | List all products | Read |\n| `hubspot_get_product` | Get a product by ID | Read |\n| `hubspot_create_product` | Create a new product | Write |\n| `hubspot_update_product` | Update a product's properties | Write |\n| `hubspot_archive_product` | Archive a product | Write |\n| `hubspot_list_line_items` | List all line items | Read |\n| `hubspot_get_line_item` | Get a line item by ID | Read |\n| `hubspot_create_line_item` | Create a new line item | Write |\n| `hubspot_update_line_item` | Update a line item's properties | Write |\n| `hubspot_archive_line_item` | Archive a line item | Write |\n\n### Associations\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_create_association` | Create a labeled association between two CRM records | Write |\n| `hubspot_list_associations` | List all associations for a record | Read |\n| `hubspot_delete_association` | Remove an association between two records | Write |\n\n### Properties\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_contact_properties` | List all contact properties | Read |\n| `hubspot_list_company_properties` | List all company properties | Read |\n| `hubspot_list_deal_properties` | List all deal properties | Read |\n| `hubspot_create_property` | Create a new custom property | Write |\n| `hubspot_update_property` | Update a custom property | Write |\n| `hubspot_archive_property` | Archive a custom property | Write |\n| `hubspot_create_property_group` | Create a new property group | Write |\n| `hubspot_update_property_group` | Update a property group | Write |\n| `hubspot_archive_property_group` | Archive a property group | Write |\n\n### Quotes\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_quotes` | List all quotes | Read |\n| `hubspot_get_quote` | Get a quote by ID | Read |\n| `hubspot_create_quote` | Create a new quote | Write |\n| `hubspot_update_quote` | Update a quote | Write |\n| `hubspot_archive_quote` | Archive a quote | Write |\n| `hubspot_batch_create_quotes` | Create multiple quotes in one request | Write |\n| `hubspot_batch_update_quotes` | Update multiple quotes in one request | Write |\n\n### Marketing Emails\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_marketing_emails` | List all marketing emails | Read |\n| `hubspot_get_marketing_email` | Get a marketing email by ID | Read |\n| `hubspot_create_marketing_email` | Create a new marketing email | Write |\n| `hubspot_update_marketing_email` | Update a marketing email | Write |\n| `hubspot_clone_marketing_email` | Clone an existing marketing email | Write |\n| `hubspot_delete_marketing_email` | Permanently delete a marketing email | Write |\n| `hubspot_create_draft_version` | Create or update a draft version of a marketing email | Write |\n| `hubspot_get_ab_variation` | Get A/B test variation for a marketing email | Read |\n| `hubspot_create_ab_variation` | Create an A/B test variation | Write |\n\n### Campaigns\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_campaigns` | List all marketing campaigns | Read |\n| `hubspot_get_campaign` | Get a campaign by ID | Read |\n| `hubspot_create_campaign` | Create a new marketing campaign | Write |\n| `hubspot_update_campaign` | Update a campaign | Write |\n| `hubspot_delete_campaign` | Delete a campaign | Write |\n\n### Workflows\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_workflows` | List all workflows | Read |\n| `hubspot_get_workflow` | Get a workflow by ID | Read |\n| `hubspot_create_workflow` | Create a new workflow | Write |\n| `hubspot_update_workflow` | Update a workflow's settings or actions | Write |\n| `hubspot_delete_workflow` | Delete a workflow | Write |\n| `hubspot_enroll_in_workflow` | Enroll a contact in a workflow | Write |\n\n### Tasks & Notes\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_tasks` | List all tasks | Read |\n| `hubspot_get_task` | Get a task by ID | Read |\n| `hubspot_create_task` | Create a new task | Write |\n| `hubspot_update_task` | Update a task | Write |\n| `hubspot_archive_task` | Archive a task | Write |\n| `hubspot_create_note` | Create a note on a CRM record | Write |\n\n### Engagement (Emails, Calls, Meetings)\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_engagements` | List all engagements (emails, calls, meetings) | Read |\n| `hubspot_create_engagement` | Create an engagement record | Write |\n| `hubspot_get_engagement` | Get an engagement by ID | Read |\n\n### Owners & Teams\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_owners` | List all HubSpot owners | Read |\n| `hubspot_get_owner` | Get a specific owner by ID | Read |\n| `hubspot_list_teams` | List all teams | Read |\n| `hubspot_get_team` | Get a team by ID | Read |\n| `hubspot_create_team` | Create a new team | Write |\n| `hubspot_update_team` | Update a team | Write |\n| `hubspot_delete_team` | Delete a team | Write |\n\n### Import & Export\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_list_imports` | List all import jobs | Read |\n| `hubspot_get_import` | Get status and details of an import | Read |\n| `hubspot_create_import` | Create a new CRM import job | Write |\n| `hubspot_cancel_import` | Cancel an active import | Write |\n| `hubspot_fetch_import_errors` | Get error details for a failed import | Read |\n\n### GDPR\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_delete_contact_gdpr` | Permanently delete a contact and associated data | Write |\n| `hubspot_delete_company_gdpr` | Permanently delete a company and associated data | Write |\n| `hubspot_delete_deal_gdpr` | Archive a deal (GDPR permanent delete not supported for deals) | Write |\n\n### Account & Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `hubspot_get_account_info` | Get current account info (email, hub ID, user details) | Read |\n| `hubspot_list_owners` | List all owners | Read |\n\n## Code Examples\n\n### List recent contacts\n\n```bash\nclawlink_call_tool --tool \"hubspot_list_contacts\" \\\n  --params '{\n    \"limit\": 20,\n    \"properties\": [\"firstname\", \"lastname\", \"email\", \"phone\"]\n  }'\n```\n\n### Search contacts by email\n\n```bash\nclawlink_call_tool --tool \"hubspot_search_contacts\" \\\n  --params '{\n    \"query\": \"john.smith@example.com\"\n  }'\n```\n\n### Create a new deal\n\n```bash\nclawlink_call_tool --tool \"hubspot_create_deal\" \\\n  --params '{\n    \"properties\": {\n      \"dealname\": \"Enterprise Contract\",\n      \"amount\": \"50000\",\n      \"dealstage\": \"qualifiedtobuy\",\n      \"pipeline\": \"default\"\n    }\n  }'\n```\n\n### Create a contact from natural language\n\n```bash\nclawlink_call_tool --tool \"hubspot_create_contact_from_nl\" \\\n  --params '{\n    \"description\": \"John Smith works as CTO at Acme Corp, his email is john@acme.com and phone is 555-0100\"\n  }'\n```\n\n### Create a note on a contact\n\n```bash\nclawlink_call_tool --tool \"hubspot_create_note\" \\\n  --params '{\n    \"engagement\": {\n      \"active\": true,\n      \"type\": \"NOTE\"\n    },\n    \"metadata\": {\n      \"body\": \"Discussed Q4 renewal. Customer interested in upgrading to enterprise plan.\"\n    },\n    \"associations\": {\n      \"contact_ids\": [\"CONTACT_ID\"]\n    }\n  }'\n```\n\n### Archive a contact\n\n```bash\nclawlink_call_tool --tool \"hubspot_archive_contact\" \\\n  --params '{\n    \"contact_id\": \"YOUR_CONTACT_ID\"\n  }'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm HubSpot is connected.\n2. Call `clawlink_list_tools --integration hubspot` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `hubspot`.\n5. If no HubSpot tools appear, direct the user to https://claw-link.dev/dashboard?add=hubspot.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  READ OPERATIONS (Safe)                                     │\n│  list → search → get → call                                 │\n│                                                             │\n│  Example: List contacts → Search → Get details → Show        │\n└─────────────────────────────────────────────────────────────┘\n                              │\n                              ▼\n┌─────────────────────────────────────────────────────────────┐\n│  WRITE OPERATIONS (Require Confirmation)                    │\n│  describe → preview → confirm → call                        │\n│                                                             │\n│  Example: Describe tool → Preview → User approves            │\n│           → Execute create/update/archive                    │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. 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.\n\n## Notes\n\n- Contact, company, deal, and ticket IDs are stable HubSpot internal IDs — use them directly in API calls.\n- Properties use internal names (e.g., `dealname`, `amount`, `closedate`) not display labels.\n- Dates must be in ISO 8601 format (e.g., `2024-03-15`).\n- Batch operations support up to 100 records per request.\n- `create_X_from_nl` tools use an LLM to parse natural language into the correct property payload.\n- Archiving is a soft delete — records move to the recycling bin and can often be restored.\n- GDPR permanent deletion erases contact data per compliance requirements.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration hubspot`. |\n| Missing connection | HubSpot is not connected. Direct the user to https://claw-link.dev/dashboard?add=hubspot. |\n| `RESOURCE_NOT_FOUND` | Record does not exist. Check the ID. |\n| `INVALID_PROPERTY_VALUE` | Property value doesn't match expected format. Check property definitions. |\n| `INVALID_ARGUMENT` | Invalid parameter or missing required field. Review the tool schema with `clawlink_describe_tool`. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n   ```bash\n   openclaw plugins list\n   ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n   ```bash\n   openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n   openclaw gateway restart\n   ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `hubspot`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [HubSpot API Documentation](https://developers.hubspot.com/docs/overview)\n- [CRM API Reference](https://developers.hubspot.com/docs/api/crm/contacts)\n- [Deals API Reference](https://developers.hubspot.com/docs/api/crm/deals)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=hubspot-ops\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=hubspot-ops)** — an integration hub for OpenClaw\n\n![ClawLink Logo](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/logo/link_logo_black_small.png)","tags":{"latest":"1.0.5"},"stats":{"comments":0,"downloads":1709,"installsAllTime":66,"installsCurrent":11,"stars":6,"versions":5},"createdAt":1777821503713,"updatedAt":1780989104739},"latestVersion":{"version":"1.0.5","createdAt":1780989104739,"changelog":"Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.","license":"MIT-0"},"metadata":null,"owner":{"handle":"hith3sh","userId":"s173vws87a7ss71xf9rq53k5gd8568kv","displayName":"Jay","image":"https://avatars.githubusercontent.com/u/83839061?v=4"},"moderation":null}