如何通过API批量更新Smartsheet用户备用邮箱地址？

当然可以通过Smartsheet API完成批量更新用户备用邮箱的操作，刚好能避开你担心的域名二次验证问题，下面是针对API新手的实操步骤：

步骤1：导出所有用户列表 #

首先得拿到所有待更新用户的ID和当前邮箱信息，调用GET /users接口即可：

curl "https://api.smartsheet.com/2.0/users?includeAll=true" \
-H "Authorization: Bearer YOUR_API_TOKEN"

这个请求会返回所有用户的完整数据，包括id（用户唯一标识）、email、alternateEmails等字段，把结果保存成JSON文件备用。如果用户量极大，建议用page和pageSize参数分页获取，避免单次请求超时。

步骤2：构造批量更新的请求体 #

Smartsheet支持通过PUT /users/bulk接口批量更新用户信息。你需要遍历导出的用户列表，按规则替换备用邮箱（比如把xxx@old-domain.com换成xxx@new-domain.com），然后构造如下格式的JSON请求体：

{
  "users": [
    {
      "id": 123456,
      "alternateEmails": ["john.doe@new-domain.com"]
    },
    {
      "id": 789012,
      "alternateEmails": ["jane.smith@new-domain.com"]
    }
  ]
}

• 如果需要保留原有备用邮箱，把新旧邮箱都放进alternateEmails数组即可；如果要完全替换，只填新域邮箱。
• 把这个JSON内容保存成update-users.json文件。

步骤3：发送批量更新请求 #

用curl执行更新操作：

curl -X PUT "https://api.smartsheet.com/2.0/users/bulk" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '@update-users.json'

关键注意事项 #

• 你的API令牌必须拥有管理员权限，否则无法修改用户信息。
• 先拿1-2个用户做测试更新，确认结果符合预期后再批量操作，避免误改。
• API操作不需要在Smartsheet UI验证域名，完全规避了你担心的二次验证风险。

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