使用Notion API创建用户遇Invalid Request Url错误，SCIM API报500错误

一、Notion普通API（v1/users）创建用户返回400错误 #

问题原因 #

Notion的https://api.notion.com/v1/users端点仅支持GET请求，用于查询已存在的用户列表或单个用户信息，不支持POST请求创建用户。因此你发送POST请求会直接返回invalid_request_url错误，和请求体参数无关。

解决方式 #

创建用户必须使用Notion SCIM API（仅适用于Notion企业版），这是Notion官方唯一支持批量/手动创建用户的API接口。

二、Notion SCIM API添加name/emails参数返回500错误 #

问题排查与解决步骤 #

• 移除Notion-Version请求头
  SCIM API是独立于Notion普通API的接口，不需要携带Notion-Version头。当前请求中包含该头可能导致服务器解析异常，引发500错误。

• 规范请求体字段格式
  确保name和emails字段严格符合SCIM规范，以下是验证有效的请求体示例：

  {
      "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
      "userName": "temployee001@beyondfinance.com",
      "name": {
          "givenName": "Test",
          "familyName": "Employee"
      },
      "emails": [
          {
              "value": "temployee001@beyondfinance.com",
              "type": "work",
              "primary": true
          }
      ]
  }
  

  注：emails数组中添加type字段（值为work/home等），可避免服务器端格式校验异常。

• 确认邮箱未被占用
  若目标邮箱已注册Notion个人账号，SCIM创建用户会失败，可更换未注册的测试邮箱尝试。

• 校验API Token权限
  确保你的SCIM Token拥有Manage users权限，可在Notion Admin面板的SCIM设置中确认权限范围。

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