Zoho crm Logo

创建个人资料

目的

要在您的 Zoho CRM 组织中创建一个配置文件。

端点

  • POST /settings/profiles/{clone_profile_ID}/actions/clone

请求详情

请求 URL

{api-domain}/crm/{version}/settings/profiles/{clone_profile_ID}/actions/clone  
其中,clone-profile-id 是您要克隆的现有配置文件 的唯一 ID。使用获取配置文件 API来获取此 ID。

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.settings.profiles.ALL
(或)
ZohoCRM.settings.profiles.CREATE

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/profiles/3652397000000026011/actions/clone"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@inputData.json"

输入 JSON

  • namestring,必填

    新配置文件的名称。最多接受 50 个字符。

  • descriptionstring,可选

    该配置文件的描述。最多接受 250 个字符。

注意

  • 您可以在一次 API 调用中创建一个配置文件。
  • 默认情况下,当您克隆一个配置文件(请求 URL 中指定的父配置文件)时,新建的配置文件将在您的 Zoho CRM 中继承相同的访问权限。不过,如需修改新配置文件的访问权限,您可以使用 Update 配置文件权限 API。

样例输入

Copied{
    "profiles": [
        {
            "name": "Sales Manager",
            "description": "Manages Sales for the TX region"
        }
    ]
}

可能的错误

  • NO_PERMISSIONHTTP 403

    您没有创建配置文件的权限
    解决方法:联系您的管理员以升级您的权限。

  • DUPLICATE_DATAHTTP 404

    您尝试创建的配置文件已存在
    解决方法:配置文件名称是唯一的。请使用不同的名称创建配置文件。

  • PROFILE_LIMIT_EXCEEDEDHTTP 404

    您的组织最多可以拥有 25 个配置文件
    解决方法: Delete不需要的配置文件,以便在最大限制内创建新的配置文件。

示例响应

Copied{
    "profiles": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "3652397000009590009"
            },
            "message": "profile created successfully",
            "status": "success"
        }
    ]
}