Zoho crm Logo

添加用户

目的

将用户添加到您的组织。

端点

  • POST /users

Request 详情

Request URL

{api-domain}/crm/{version}/users

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.users.{operation_type}

可能的操作类型

ALL - 全部权限给用户
CREATE - 创建用户

注意

  • 您只能在每个POST请求中添加一个用户。
  • 不支持通过API添加CRM Plus用户。您只能通过用户界面添加CRM Plus用户。
  • 您必须在输入中只使用字段API名称。您可以从字段元数据API(每个字段的“api_name”键的值)获取字段API名称。

样本请求

在请求中,“@newuser.json”包含了样本输入数据。

Request JSON
  • first_name字符串,必填

    指定用户的名字。

  • email字符串,必填

    指定用户的电子邮件ID。

  • role字符串,必填

    指定您想要分配给用户的角色的唯一ID。您可以从角色API获取角色ID。

  • profile字符串,必填

    指定您想要分配给用户的配置文件的唯一ID,以决定用户对CRM数据的访问级别。您可以从配置文件API获取配置文件ID。

请参考添加记录API了解字段类型和限制。

样本输入

可能的错误

  • INVALID_REQUESTHTTP 400

    无法在CRM Plus账户下添加用户。请使用CRMPlus URL添加用户。
    解决方案: API不支持添加CRM Plus用户。您只能通过用户界面添加CRM Plus用户。请参阅上述注释部分。

  • LICENSE_LIMIT_EXCEEDEDHTTP 400

    Request超过了您的许可证限制。需要升级以便添加。
    解决方案:您可以根据您的CRM计划添加的用户数量已经超过。请购买额外的用户许可证以添加更多用户。

  • DUPLICATE_DATAHTTP 400

    由于相同的电子邮件ID已存在,无法添加用户
    解决方案:您输入了电子邮件_id的重复值。请确保为电子邮件_id和last_name字段提供唯一的值。

  • MANDATORY_NOT_FOUNDHTTP 400

    姓氏是必需的
    解决方案:您没有指定其中一个必需的键。请参考上面的请求JSON部分。

  • INVALID_DATAHTTP 400

    无效的数据。有效的值包括逗号/空格/句点/无。
    解决方案:指定的键值无效。它只能包含上述特殊字符。

  • INVALID_DATAHTTP 400

    由于此用户已拒绝发送的邀请,因此无法添加
    解决方案:您不能添加已拒绝加入您的组织的用户。

  • 禁止HTTP 403

    权限被拒绝
    解决方案:只有用户配置文件为“管理员”的用户才能添加新用户。请联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请检查尝试访问的URL是否正确
    解决方案:指定的请求URL不正确。请指定一个有效的请求URL。请参考上面的请求URL部分。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方案:客户端没有ZohoCRM.users.CREATE范围。创建一个具有有效范围的新客户端。请参考上面的范围部分。

  • NO_PERMISSIONHTTP 403

    拒绝创建的权限
    解决方案:用户没有创建用户记录的权限。请联系您的系统管理员。

  • INTERNAL_ERRORHTTP 500

    内部服务器错误
    解决方案:服务器中出现意外且未处理的异常。请联系支持团队。

  • INVALID_REQUEST_METHODHTTP 400

    HTTP请求方法类型无效
    解决方案:您指定了无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参考上述端点部分。

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限来添加新用户
    解决方案:用户没有添加用户的权限。请联系您的系统管理员。

样本回应