使用Docusign Node SDK调用createEnvelope()报INVALID_REQUEST_PARAMETER错误

问题重现 #

使用DocuSign Node SDK从现有模板创建信封时，收到400响应，错误信息：

{"errorCode":"INVALID_REQUEST_PARAMETER","message":"The request contained at least one invalid parameter. Query parameter 'from_date' must be set to a valid DateTime or 'envelope_ids', 'folder_ids' or 'transaction_ids' must be specified."}

错误请求指向GET /restapi/v2.1/accounts/{accountId}/envelopes，推测是SDK内部自动发起的请求，而非手动调用的createEnvelope接口。

解决方案 #

1. 升级SDK到最新版本

旧版本SDK存在内部逻辑bug，创建信封后会自动触发不需要的信封列表查询请求，且未携带必填参数。执行升级命令：

npm install docusign-esign@latest

2. 显式指定返回字段（兼容旧版本）

若暂时无法升级，在调用createEnvelope时通过include参数指定要返回的字段，阻止SDK自动发起额外请求：

const envelope = await envelopesAPI.createEnvelope(
  this.configService.get('docusign.auth.accountId'),
  {
    envelopeDefinition: envelopeDefinition,
    // 指定仅返回核心字段，避免SDK触发列表查询
    include: 'envelopeId,status'
  },
);

3. 检查API客户端配置

确认dsApiClient未被错误添加全局默认查询参数，比如是否在其他代码中设置了from_date参数但未赋值，导致后续请求携带无效参数。

原因分析 #

错误并非来自创建信封的POST请求，而是SDK在创建完成后，内部尝试调用信封列表接口获取数据，但未传递该接口要求的必填参数（from_date或任一ID集合参数）。这类问题多由SDK版本bug或配置不当引发。

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