适合什么时候用
接口面极窄，目的非常清晰
先注意什么
只解决事件写入，不是报表读取面
第一步先查
先确认你的应用具备 analytics.behavioral_events.send scope，再从 /events/v3/send 发一条最小事件，检查事件名和属性结构是否被 HubSpot 正常接收。
认证
oauth
CORS
不支持
HTTPS
是
注册
需要
延迟
463 ms
协议
REST
计费
—
可用率 · 30 天窗口
巡检: 1可用率: 100%平均延迟: 463ms
01
关于这个 API
这份接口不是做 CRM 读写，而是专门给自定义行为事件上报用的。它的核心路径只有 /events/v3/send，外加 analytics.behavioral_events.send 这个明确 scope。 当前资源面包含 "/events/v3/send"，并且还能看到 "Behavioral_Events_Tracking" 这些分组。
对后端团队来说，这很适合把产品行为事件写进 HubSpot、把自定义事件接到营销自动化流程，或者统一从服务端发送行为追踪。spec 里能看到 "analytics.behavioral_events.send" 这类 scope。
只解决事件写入，不是报表读取面 鉴权命名带 legacy，接入时要确认你实际采用的方案
02
你可以做什么
- 1把产品行为事件写进 HubSpot
- 2把自定义事件接到营销自动化流程
- 3统一从服务端发送行为追踪
03
优劣对比
优点
- 接口面极窄，目的非常清晰
- scope 直接说明是 behavioral events send
- 兼容 hapikey、oauth2_legacy 与 private_apps_legacy 三种鉴权名
注意事项
- 只解决事件写入，不是报表读取面
- 鉴权命名带 legacy，接入时要确认你实际采用的方案
04
示例请求
通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl https://hubapi.com/<endpoint> \
-H "Authorization: Bearer $ACCESS_TOKEN"05
快速开始
先确认你的应用具备 analytics.behavioral_events.send scope，再从 /events/v3/send 发一条最小事件，检查事件名和属性结构是否被 HubSpot 正常接收。
06
技术细节
CORS: NoHTTPS: Yes注册: Yes开源: No
- 认证方式
- oauth
- 计费
- unknown
- 协议
- REST
- 响应时间
- 463 ms
- 上次巡检
- 2026/5/12 07:37:39