# Send Hubspot Suite to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "hubspot-suite",
    "name": "Hubspot Suite",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Luigi08001/hubspot-suite",
    "canonicalUrl": "https://clawhub.ai/Luigi08001/hubspot-suite",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/hubspot-suite",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hubspot-suite",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/associations.md",
      "references/auth-setup.md",
      "references/crm-companies.md",
      "references/crm-contacts.md",
      "references/crm-deals.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/hubspot-suite"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/hubspot-suite",
    "downloadUrl": "https://openagent3.xyz/downloads/hubspot-suite",
    "agentUrl": "https://openagent3.xyz/skills/hubspot-suite/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hubspot-suite/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hubspot-suite/agent.md"
  }
}
```
## Documentation

### HubSpot Suite - Complete CRM & Marketing Platform

The ultimate HubSpot skill covering ALL aspects of the platform: CRM, Marketing, Sales, Service, CMS, and Developer tools.

### 1. Authentication Setup

# Private App (Recommended)
export HUBSPOT_ACCESS_TOKEN="pat-na1-xxx"  # or pat-eu1-xxx

# Legacy API Key
export HUBSPOT_API_KEY="your-api-key"

See references/auth-setup.md for complete authentication guide including new Developer Platform.

### 2. Basic API Test

curl -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \\
  "https://api.hubapi.com/crm/v3/objects/contacts?limit=1"

### What Do You Want To Do?

CRM Management:

references/crm-contacts.md → Create, update, search contacts
references/crm-companies.md → Company records, hierarchies
references/crm-deals.md → Sales pipeline, deal stages
references/crm-tickets.md → Support tickets, SLA management
references/crm-custom-objects.md → Custom object schemas

Data & Associations:

references/associations.md → Link records (contact→company, deal→contact)
references/properties.md → Custom properties, field groups
references/data-quality.md → Deduplication, data cleanup
references/import-export.md → Bulk data migration

Activities & Automation:

references/engagements.md → Log calls, emails, meetings, tasks
references/workflows.md → Automation, triggers, enrollment
references/pipelines.md → Configure pipelines, stages

Marketing & Sales:

references/lists.md → Contact lists, segmentation
references/forms.md → Landing page forms
references/email-marketing.md → Email campaigns
references/conversations.md → Live chat, chatbots

Analytics & Reporting:

references/reporting.md → Custom dashboards, KPIs
references/webhooks.md → Real-time event notifications

Content & Commerce:

references/cms.md → Website pages, blog posts, HubDB
references/commerce.md → Products, quotes, invoices

Platform & Development:

references/developer-platform.md → HubSpot CLI, custom apps
references/owners.md → User management, permissions
references/knowledge-base-tips.md → UI navigation, admin tasks

### 1. Import Contacts from CSV

./scripts/bulk-import.sh contacts contacts.csv

### 2. Find & Merge Duplicate Contacts

./scripts/find-duplicates.sh contacts email
./scripts/merge-records.sh contacts ID1 ID2

### 3. Create Deal with Associations

# Create deal
curl -X POST "https://api.hubapi.com/crm/v3/objects/deals" \\
  -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "properties": {
      "dealname": "Big Deal",
      "amount": "50000",
      "dealstage": "qualifiedtobuy"
    }
  }'

# Associate to contact (type 3 = deal→contact)
curl -X PUT "https://api.hubapi.com/crm/v3/objects/deals/DEAL_ID/associations/contacts/CONTACT_ID/3" \\
  -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN"

### 4. Data Quality Audit

./scripts/data-audit.sh

### 5. Export Pipeline Report

./scripts/pipeline-report.sh > pipeline_report.csv

### 6. Log Activity (Call/Email/Meeting)

# Log a sales call
curl -X POST "https://api.hubapi.com/crm/v3/objects/calls" \\
  -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "properties": {
      "hs_call_title": "Discovery Call",
      "hs_call_duration": "1800000",
      "hs_call_disposition": "Connected"
    },
    "associations": [{
      "to": { "id": "CONTACT_ID" },
      "types": [{ "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 194 }]
    }]
  }'

### Script Usage

All scripts are in scripts/ directory. Make executable first:

chmod +x scripts/*.sh

Universal API Helper:

./scripts/hs-api.sh GET /crm/v3/objects/contacts
./scripts/hs-api.sh POST /crm/v3/objects/companies '{"properties":{"name":"ACME"}}'

Data Management:

./scripts/bulk-import.sh [object-type] [csv-file]
./scripts/bulk-export.sh [object-type] [output-file]
./scripts/find-duplicates.sh [object-type] [property]
./scripts/merge-records.sh [object-type] [primary-id] [duplicate-id]

Reports & Analytics:

./scripts/data-audit.sh > audit-report.txt
./scripts/pipeline-report.sh > pipeline-analysis.csv

### Rate Limits

Private Apps: 100 requests/10 seconds
OAuth Apps: 100 requests/10 seconds
Search API: 4 requests/second
Batch Operations: 100 records max per request

### Pagination

All list endpoints use after parameter:

curl "https://api.hubapi.com/crm/v3/objects/contacts?after=12345&limit=100"

### Error Handling

429: Rate limit exceeded → Wait and retry
400: Bad request → Check property names/values
401: Authentication failed → Check token/scopes
404: Object not found → Verify ID exists

### Common Headers

-H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN"
-H "Content-Type: application/json"

### Batch Operations Pattern

curl -X POST "https://api.hubapi.com/crm/v3/objects/contacts/batch/create" \\
  -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "inputs": [
      {"properties": {"firstname": "John", "lastname": "Doe"}},
      {"properties": {"firstname": "Jane", "lastname": "Smith"}}
    ]
  }'

### Filter Syntax

{
  "filters": [{
    "propertyName": "email",
    "operator": "EQ",
    "value": "john@example.com"
  }]
}

### Operators

EQ, NEQ: Equals, not equals
LT, LTE, GT, GTE: Less/greater than
CONTAINS_TOKEN: Contains word
HAS_PROPERTY, NOT_HAS_PROPERTY: Property exists
IN, NOT_IN: Value in list
BETWEEN: Numeric/date range

### Advanced Search Example

curl -X POST "https://api.hubapi.com/crm/v3/objects/contacts/search" \\
  -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "filters": [{
      "propertyName": "createdate",
      "operator": "GTE", 
      "value": "2024-01-01"
    }],
    "sorts": [{"propertyName": "createdate", "direction": "DESCENDING"}],
    "limit": 100
  }'

### Environment Variables

Set these in your shell/environment:

# Required
export HUBSPOT_ACCESS_TOKEN="pat-na1-xxx"  # Private app token

# Optional  
export HUBSPOT_API_KEY="xxx"               # Legacy API key
export HUBSPOT_PORTAL_ID="12345"           # For some API calls
export HUBSPOT_BASE_URL="https://api.hubapi.com"  # Override for testing

### Need Help?

API Issues: Check references/rate-limits.md and references/search-filters.md
Authentication: See references/auth-setup.md
UI Tasks: Check references/knowledge-base-tips.md
Data Problems: Use references/data-quality.md
Specific Objects: Find the relevant references/crm-*.md file

This skill covers the entire HubSpot platform. Start with the reference file that matches your task, then use the scripts to automate repetitive operations.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Luigi08001
- Version: 1.2.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/hubspot-suite)
- [Send to Agent page](https://openagent3.xyz/skills/hubspot-suite/agent)
- [JSON manifest](https://openagent3.xyz/skills/hubspot-suite/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/hubspot-suite/agent.md)
- [Download page](https://openagent3.xyz/downloads/hubspot-suite)