HubSpot 技能

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

设置

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

HUBSPOTACCESSTOKEN=pat-na2-xxxxx

API 基础地址

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

授权头：Bearer $HUBSPOTACCESSTOKEN

CRM 对象

联系人

创建联系人：
bash
curl -s -X POST -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-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

列出联系人：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/objects/contacts?limit=10 | jq

搜索联系人：
bash
curl -s -X POST -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-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 获取联系人：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/objects/contacts/{contactId}?properties=email,firstname,lastname,phone,company | jq

按邮箱获取联系人：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/objects/contacts/{email}?idProperty=email | jq

公司

列出公司：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/objects/companies?limit=10&properties=name,domain,industry | jq

搜索公司：
bash
curl -s -X POST -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-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 获取公司：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/objects/companies/{companyId}?properties=name,domain,industry,numberofemployees | jq

交易

创建交易：
bash
curl -s -X POST -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-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

列出交易：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/objects/deals?limit=10&properties=dealname,amount,dealstage,closedate | jq

搜索交易：
bash
curl -s -X POST -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-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 获取交易：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/objects/deals/{dealId}?properties=dealname,amount,dealstage,closedate,pipeline | jq

所有者

列出所有者（用户）：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/owners | jq

更新与分配所有者

更新联系人属性：
bash
curl -s -X PATCH -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-H Content-Type: application/json \
-d {properties:{phone:555-9999,jobtitle:Director}} \
https://api.hubapi.com/crm/v3/objects/contacts/{contactId} | jq

分配所有者给联系人：
bash
curl -s -X PATCH -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-H Content-Type: application/json \
-d {properties:{hubspotownerid:{ownerId}}} \
https://api.hubapi.com/crm/v3/objects/contacts/{contactId} | jq

分配所有者给交易：
bash
curl -s -X PATCH -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-H Content-Type: application/json \
-d {properties:{hubspotownerid:{ownerId}}} \
https://api.hubapi.com/crm/v3/objects/deals/{dealId} | jq

关联

获取公司的关联联系人：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v4/objects/companies/{companyId}/associations/contacts | jq

获取联系人的关联交易：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v4/objects/contacts/{contactId}/associations/deals | jq

创建关联（交易到联系人）：
bash
curl -s -X POST -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
-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：联系人到公司

属性（模式）

列出联系人属性：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/properties/contacts | jq .results[].name

列出公司属性：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/properties/companies | jq .results[].name

列出交易属性：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/crm/v3/properties/deals | jq .results[].name

CMS

页面

列出网站页面：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/cms/v3/pages/site-pages?limit=10 | jq

列出落地页：
bash
curl -s -H Authorization: Bearer $HUBSPOTACCESSTOKEN \
https://api.hubapi.com/cms/v3/pages