能否使用非字符串类型令牌创建HubSpot CRM时间线事件？

HubSpot的API本身支持数值、日期等非字符串类型的令牌值，但官方@hubspot/api-client的TypeScript类型定义做了严格限制（tokens被定义为[key: string]: string）。你可以通过以下几种方式绕过这个限制：

• 类型断言绕过TypeScript检查
  直接将tokens对象断言为any或更宽松的类型，就能传入非字符串类型的值：

  import { Client } from '@hubspot/api-client';
  
  const hubspotClient = new Client({ accessToken: 'YOUR_TOKEN' });
  
  const createEvent = async () => {
    await hubspotClient.crm.timeline.events.create({
      objectId: 'CONTACT_ID',
      eventTemplateId: 'TEMPLATE_ID',
      tokens: {
        numeric_value: 100,
        date_value: new Date().toISOString()
      } as any // 用类型断言跳过TS检查
    });
  };
  

• 手动构造请求Payload
  跳过官方客户端的类型封装，直接用HTTP请求库（如axios、fetch）构造符合API要求的请求体，自由设置令牌类型：

  import axios from 'axios';
  
  const createTimelineEvent = async () => {
    await axios.post(
      'https://api.hubapi.com/crm/v3/timeline/events',
      {
        objectId: 'CONTACT_ID',
        eventTemplateId: 'TEMPLATE_ID',
        tokens: {
          numeric_value: 100,
          date_value: '2024-05-20T14:30:00Z'
        }
      },
      {
        headers: {
          'Authorization': `Bearer YOUR_TOKEN`,
          'Content-Type': 'application/json'
        }
      }
    );
  };
  

• 日期类型的特殊处理
  日期类型无需强行传入Date对象，转成ISO 8601格式的字符串即可，HubSpot后端会自动解析为日期类型，完全满足模板的日期令牌需求。

如果官方客户端的类型限制对你的开发造成困扰，也可以在其GitHub仓库提交issue反馈，但短期来看上述两种方法是最直接的解决方案。

内容的提问来源于stack exchange，提问作者user2943799