创建联系人

POST

https://www.bangwo8.com/api/v1/users.json

最后修改时间：2026-04-06 05:16:25

责任人：未设置

唯一标识

联系人是与手机号码一一对应，因此：
1、2B模式下，不同公司下可以有相同联系人（手机号码），同一公司下不能有相同联系人（手机号码）（即：同一个人可能出现在多个公司里，但同一个人不能在同一公司出现两次）；
2、2C模式下，没有公司概念，所有联系人在一起，不能有相同联系人（手机号码）
否则通过API创建联系人时会报错：

[{"errorMsg":"The mobile has been used","status":"110017"}]

自定义字段

下拉类型字段，传选选项ID，如：{"key":"select_key","value":"id1"}

单选类型字段，传1和0，如：{"key":"radio_key","value":"1"}

多选类型字段，多个选项英文逗号分割，如：{"key":"checkbox_key","value":"1,2"}

级联类型字段，传数组，如：{"key":"cascade_key","value":["北京市","海淀","清华大学"]}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Header 参数

Body 参数application/json

示例

{
  "user": {
    "realName": "用户名",
    "mobile": "18616881688",
    "email": "zhangsan@example.com",
    "phone": "400-12345678",
    "position": "职位",
    "QQ": "123456",
    "note": "备注",
    "custom_fields": [
      {
        "key": "select_key",
        "value": "232"
      },
      {
        "key": "radio_key",
        "value": "1"
      },
      {
        "key": "checkbox_key",
        "value": "21,23"
      },
      {
        "key": "cascade_key",
        "value": [
          "北京市",
          "海淀区",
          "中关村北大街"
        ]
      }
    ]
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.bangwo8.com/api/v1/users.json' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "user": {
    "realName": "用户名",
    "mobile": "18616881688",
    "email": "zhangsan@example.com",
    "phone": "400-12345678",
    "position": "职位",
    "QQ": "123456",
    "note": "备注",
    "custom_fields": [
      {
        "key": "select_key",
        "value": "232"
      },
      {
        "key": "radio_key",
        "value": "1"
      },
      {
        "key": "checkbox_key",
        "value": "21,23"
      },
      {
        "key": "cascade_key",
        "value": [
          "北京市",
          "海淀区",
          "中关村北大街"
        ]
      }
    ]
  }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "user": {
        "cId": "54499496",
        "name": "",
        "mobile": "18616881688",
        "email": "zhangsan@example.com",
        "fixnumber": "",
        "position": "职位",
        "QQ": "123456",
        "note": "备注",
        "status": "1",
        "companyId": "0",
        "supportId": "0",
        "multiServiceList": "",
        "default": "",
        "service_groupid": "",
        "createDT": "2026-04-04 22:26:12",
        "updateDT": "",
        "tableName": "",
        "custom_fields": [
            {
                "key": "field_2",
                "value": ""
            },
            {
                "key": "authaccount",
                "value": ""
            },
            {
                "key": "field_4",
                "value": "否"
            },
            {
                "key": "wechatdept",
                "value": ""
            },
            {
                "key": "field_3",
                "value": ""
            }
        ]
    }
}

修改于 2026-04-06 05:16:25

搜索联系人

修改联系人