HubSpot_知识管理 skill-PHP中文网

HubSpot

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

HubSpot CRM与CMS API集成，用于联系人、公司、交易、所有者及内容管理。

HubSpot Skill. 通过 REST API与 HubSpot CMM 和 CMS 交互.

功能概述

HubSpot Skill. 通过 REST API与 HubSpot CMM 和 CMS 交互.是一项面向实际任务的技能，主要用于Setup. 设置您的 HubSpot 私人 App 访问令牌:.；API Base. 所有端点使用: https://api.hubapi.com.；

核心要点

Authorization header: Bearer $。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

HubSpot Skill

通过 REST API 与 HubSpot CRM 和 CMS 进行交互。

配置

设置 HubSpot 私有应用访问令牌：

HUBSPOT_ACCESS_TOKEN=pat-na2-xxxxx

API 基础地址

所有端点均使用：https://api.hubapi.com

授权请求头：Bearer $HUBSPOT_ACCESS_TOKEN

CRM 对象

联系人（Contacts）

创建联系人：

curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"properties":{"email":"test@example.com","firstname":"Test","lastname":"User","phone":"555-1234","company":"Acme Inc","jobtitle":"Manager"}}' 
  "https://api.hubapi.com/crm/v3/objects/contacts" | jq

列出联系人：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/objects/contacts?limit=10" | jq

搜索联系人：

curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"filterGroups":[{"filters":[{"propertyName":"email","operator":"CONTAINS_TOKEN","value":"example.com"}]}],"limit":10}' 
  "https://api.hubapi.com/crm/v3/objects/contacts/search" | jq

根据 ID 获取联系人：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/objects/contacts/{contactId}?properties=email,firstname,lastname,phone,company" | jq

根据邮箱获取联系人：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/objects/contacts/{email}?idProperty=email" | jq

公司（Companies）

列出公司：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/objects/companies?limit=10&properties=name,domain,industry" | jq

搜索公司：

curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"filterGroups":[{"filters":[{"propertyName":"name","operator":"CONTAINS_TOKEN","value":"acme"}]}],"limit":10}' 
  "https://api.hubapi.com/crm/v3/objects/companies/search" | jq

根据 ID 获取公司：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/objects/companies/{companyId}?properties=name,domain,industry,numberofemployees" | jq

交易（Deals）

创建交易：

curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"properties":{"dealname":"New Deal","amount":"10000","closedate":"2026-06-01","description":"Deal notes here"}}' 
  "https://api.hubapi.com/crm/v3/objects/deals" | jq

列出交易：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/objects/deals?limit=10&properties=dealname,amount,dealstage,closedate" | jq

搜索交易：

curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"filterGroups":[{"filters":[{"propertyName":"dealstage","operator":"EQ","value":"closedwon"}]}],"limit":10}' 
  "https://api.hubapi.com/crm/v3/objects/deals/search" | jq

根据 ID 获取交易：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/objects/deals/{dealId}?properties=dealname,amount,dealstage,closedate,pipeline" | jq

负责人（Owners）

列出负责人（用户）：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/owners" | jq

更新与分配负责人

更新联系人属性：

curl -s -X PATCH -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"properties":{"phone":"555-9999","jobtitle":"Director"}}' 
  "https://api.hubapi.com/crm/v3/objects/contacts/{contactId}" | jq

为联系人分配负责人：

curl -s -X PATCH -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"properties":{"hubspot_owner_id":"{ownerId}"}}' 
  "https://api.hubapi.com/crm/v3/objects/contacts/{contactId}" | jq

为交易分配负责人：

curl -s -X PATCH -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"properties":{"hubspot_owner_id":"{ownerId}"}}' 
  "https://api.hubapi.com/crm/v3/objects/deals/{dealId}" | jq

关联关系（Associations）

获取某公司的关联联系人：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v4/objects/companies/{companyId}/associations/contacts" | jq

获取某联系人的关联交易：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v4/objects/contacts/{contactId}/associations/deals" | jq

创建关联（交易 → 联系人）：

curl -s -X POST -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"inputs":[{"from":{"id":"{dealId}"},"to":{"id":"{contactId}"},"types":[{"associationCategory":"HUBSPOT_DEFINED","associationTypeId":3}]}]}' 
  "https://api.hubapi.com/crm/v4/associations/deals/contacts/batch/create" | jq

常用关联类型 ID：

3：交易 → 联系人
5：交易 → 公司
1：联系人 → 公司

属性（Schema）

列出联系人属性：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/properties/contacts" | jq '.results[].name'

列出公司属性：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/properties/companies" | jq '.results[].name'

列出交易属性：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/crm/v3/properties/deals" | jq '.results[].name'

CMS

页面（Pages）

列出网站页面：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/cms/v3/pages/site-pages?limit=10" | jq

列出落地页（Landing Pages）：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/cms/v3/pages/landing-pages?limit=10" | jq

域名（Domains）

列出域名：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/cms/v3/domains" | jq

文件（Files）

列出文件：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/files/v3/files?limit=10" | jq

搜索文件：

curl -s -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" 
  "https://api.hubapi.com/files/v3/files/search?name=logo" | jq

搜索操作符（Search Operators）

在搜索端点的过滤器中，可使用以下操作符：

操作符	说明
`EQ`	等于
`NEQ`	不等于
`LT`	小于
`LTE`	小于或等于
`GT`	大于
`GTE`	大于或等于
`CONTAINS_TOKEN`	包含该词（分词匹配）
`NOT_CONTAINS_TOKEN`	不包含该词（分词匹配）
`HAS_PROPERTY`	具有值（非空）
`NOT_HAS_PROPERTY`	无值（为空）

PowerShell 示例

在 Windows / PowerShell 环境中，请使用 Invoke-RestMethod：

$headers = @{ 
  "Authorization" = "Bearer $env:HUBSPOT_ACCESS_TOKEN"
  "Content-Type" = "application/json" 
}

# 列出联系人
Invoke-RestMethod -Uri "https://api.hubapi.com/crm/v3/objects/contacts?limit=10" -Headers $headers

# 搜索联系人
$body = @{
  filterGroups = @(@{
    filters = @(@{
      propertyName = "email"
      operator = "CONTAINS_TOKEN"
      value = "example.com"
    })
  })
  limit = 10
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method POST -Uri "https://api.hubapi.com/crm/v3/objects/contacts/search" -Headers $headers -Body $body

注意事项

支持完整 CRUD 操作（需配置对应权限范围）
速率限制：私有应用为每 10 秒 100 次请求
分页：使用响应中 paging.next.after 字段的值作为下一页请求的 after 参数
门户 ID（Portal ID）位于记录 URL 中，例如：https://app-na2.hubspot.com/contacts/{portalId}/record/...