open-api
首页
首页
  1. 客户
  • 快速开始
  • 授权登录
    • 授权登录流程
    • 鉴权接口
      POST
    • 刷新令牌接口
      POST
  • 客户
    • 客户
    • 客户列表
      GET
    • 跟进动态查询接口
      GET
    • 新增客户的联系人(待修改)
      POST
    • 提交跟进动态
      POST
    • 客户分组新增/编辑
      POST
    • 删除客户分组
      POST
    • 客户阶段新增/编辑
      POST
    • 删除客户阶段
      POST
    • 客户标签新增/编辑
      POST
    • 删除客户标签
      POST
    • 客户枚举:客户类型,客户标签,时区,规模,星级,采购意向,采购额度,职级
      GET
    • 移入公海
      POST
    • 客户查重
      GET
    • 客户数据字典
      GET
    • 客户(含联系人)新增/编辑
      POST
    • 删除客户(仅支持公海客户)
      POST
    • 客户详情
      GET
    • 查询客户的阶段、分组、状态、地区、主营产品、来源
      GET
  • 销售订单
    • 销售订单
    • 销售订单枚举:货币,付款方式,国家/地区,订单类型,订单状态,订单创建方式
      GET
    • 销售订单字段
      GET
    • 销售订单删除
      POST
    • 销售订单新建/编辑
      POST
    • 销售订单列表
      GET
    • 销售订单详情
      GET
  • 采购订单
    • 采购订单
    • 采购订单列表
    • 采购订单字段
    • 采购订单状态
    • 采购订单新增/编辑
    • 采购订单详情
  • 产品
    • 产品
    • 产品枚举:产品类型,离岸价设置类型,创建方式,产品计量单位
    • 产品分组删除
    • 库存查询(通过skuId) 
    • 查询产品库列表
    • 产品新建/编辑
    • 产品库的数据字典
    • 产品详情
    • 产品分组新增/编辑
    • 删除产品规格
    • 查询产品分组
    • 新增/编辑规格
    • 查询产品规格列表
    • 增量更新产品规格值
    • 产品删除接口
    • 产品配件新建/编辑
  • 回款登记
    • 回款登记
    • 回款登记详情
    • 回款登记字段
    • 回款登记新建/编辑
    • 回款登记列表
    • 回款登记核销
  • 回款单
    • 回款单
    • 回款方式枚举
    • 回款单列表
    • 回款单字段
    • 回款单新建/编辑
    • 回款单详情
  • 付款单
    • 付款单
    • 付款单详情
    • 付款单字段
    • 付款单列表
  • 费用单
    • 费用单
    • 费用单-详情
    • 费用单字段
    • 费用项目列表
    • 费用单列表
  • 报价单
    • 报价单
    • 报价单列表
    • 报价单状态、币种查询
    • 报价单删除
    • 报价单数据字典
    • 报价单新建/编辑
    • 查询报价单详情
  • 供应商
    • 供应商
    • 供应商列表
    • 供应商字段
    • 供应商删除
    • 获取供应商产品列表
    • 供应商详情
    • 供应商新增/编辑
  • 商机
    • 商机
    • 查询商机的销售流程 商机阶段 输单原因
    • 商机删除接口
    • 商机列表
    • 商机数据查询
    • 商机数据字典
    • 商机新建/编辑接口
  • 用户
    • 用户
    • 用户部门列表
    • 用户部门详情
    • 用户列表
    • 用户详情
  • 销售出库单
    • 销售出库单
    • 销售出库单列表
    • 销售出库单详情
    • 销售出库单字段
    • 销售出库单删除
    • 新增/编辑销售出库单
  • 库存
    • 库存
    • 库存写入
    • 仓库查询
  • 线索
    • 线索
    • 线索|联系人的数据字典
    • 线索列表
    • 线索数据查询
    • 线索(含联系人)创建/编辑接口
  • 资金
    • 资金
    • 资金账户列表
  • 采购入库单
    • 采购入库单
    • 采购入库单-列表
    • 采购入库单-详情
    • 采购入库单字段
    • 采购入库单-删除
    • 采购入库单-新建/编辑
  • 采购退货单
    • 采购退货单
    • 采购退货单-列表
    • 采购退货单-详情
    • 采购退货单字段
    • 采购退货单-新建/编辑
    • 采购退货单-删除
  • 统计分析
    • 统计报告-统计详细
  • 示例接口(勿用)
    • 示例说明
    • 例子列表
    • 例子枚举值查询
  • devops相关
    • 钉钉回调
    • tapd回调接口
    • 获取智齿token
    • 智齿刷新接口
    • app版本发布
    • 钉钉管理-删除账号
  • 动态
  • 消息推送
    • 消息订阅流程
    • 创建回调配置
    • 修改回调配置
    • 获取回调配置
    • 删除回调配置
    • 测试回调接口
    • 重新生成加密密钥
    • 创建订阅配置
    • 修改订阅配置
    • 删除订阅配置
    • 获取订阅配置详情
    • 获取订阅配置列表
  • whatsapp代发对外接口
    POST
  • 数据模型
    • 新增客户联系人
    • 客户新增(仅新增)
    • 数据字典响应
    • 图片对象
首页
首页
  1. 客户

新增客户的联系人(待修改)

POST
/v1/company/push/customer

请求参数

Header 参数

Body 参数application/json

示例
{
    "company_id": 352023380, //新建时不需要传递,或者传0
    "user_id": 11858711, //操作人ID
    "is_public": 1,
    "serial_id": "", //客户编号
    "name": "open-api+{{$date.millisecondsTimestamp}}", //客户名称
    "short_name": "客户简称+{{$location.street}}",
    "country": "CN",
    "province": "陕西省",
    "city": "西安市",
    "tel_area_code": "86",
    "tel": "18920938291",
    "fax": "",
    "group_id": 0, //客户分组ID
    "pool_id": 0, //公海分组ID
    "origin_list": [
        14
    ], //来源ID列表
    "trail_status": 0,
    "biz_type": "生产商", //客户类型 来自客户枚举接口
    "cus_tag": [
        0
    ], //客户标签 来自客户枚举接口
    "address": "地址{{$location.secondaryAddress}}", //详细地址
    "remark": "公司备注", //客户备注
    "homepage": "www.ali.com",
    "star": 4, //客户星级 来自客户枚举接口
    "intention_level": 1, //采购意向 来自客户枚举接口
    "annual_procurement": 0, //年采购额 来自客户枚举接口
    "timezone": 5, //时区 来自客户枚举接口
    "scale_id": 2, //规模 来自客户枚举接口
    "image_list": [],
    "317003909": "文本字段",
    "319333155": "文本字段",
    "319354587": "文本字段",
    "319357955": "A",
    "348142520": "文本字段",
    "348159705": "多行文本本测试 嘻嘻哈哈",
    "348160052": "选项一",
    "348174646": "2026-05-08",
    "348174892": 100,
    "348175131": [],
    "348175368": [
        "选项一"
    ],
    "348175638": "2026-05-08 10:00:00",
    "348175873": 0.5,
    "348194943": "文本字段",
    "348195993": "文本字段",
    "348196009": "多行文本本测试 嘻嘻哈哈",
    "348196022": "选项一",
    "348196037": "2026-05-08",
    "348196049": 100,
    "348196054": [],
    "348196060": [
        "选项一"
    ],
    "348196066": "2026-05-08 10:00:00",
    "1101101837": "客户1-edit",
    "1101101838": "2026-05-08",
    "1101101839": 100,
    "1101101840": [
        "客户多选2-edit"
    ],
    "1101101841": "2026-05-08 10:00:00",
    "1102603643": "文本字段",
    "1105128163": "客户1-edit",
    "1105128171": "2026-05-08",
    "1105162749": "多行文本本测试 嘻嘻哈哈",
    "1514096184": "文本字段",
    "3082019289": "2026-05-08 10:00:00",
    "3455469523": "文本字段",
    "3493496861": "文本字段",
    "3493497310": "多行文本本测试 嘻嘻哈哈",
    "3493497316": "公司选项1",
    "3493497327": [
        "公司选项A"
    ],
    "3493497331": "2026-05-08",
    "3493497349": 100,
    "3493497372": [],
    "3493497382": "2026-05-08 10:00:00",
    "3555002419": [],
    "58218823169": "",
    "58214487467": "优质",
    "58199842716": "2026-05-08",
    "58161687747": "111",
    "57665595218": "文本字段",
    "57665415410": "2026-05-08 10:00:00",
    "57665401469": 0.5,
    "57665083623": "1",
    "57664468368": "多行文本本测试 嘻嘻哈哈",
    "57607745365": "多行文本本测试 嘻嘻哈哈",
    "57563952576": "文本字段",
    "57236146973": "多行文本本测试 嘻嘻哈哈",
    "57236146540": "文本字段",
    "57236146342": "文本字段",
    "57234714818": 100,
    "57234714792": 100,
    "57229828373": "文本字段",
    "57221915113": [
        "1"
    ],
    "57172556677": "2026-05-08",
    "55905073554": 0.5,
    "5218116642": [
        "客户下拉多选2"
    ],
    "next_follow_up_time": "2025-03-03 00:00:00", //下次跟进时间
    "category_ids": [
        [
            3
        ]
    ], //主营产品ID
    "product_group_ids": [], //产品分组ID
    "customers": [
        {
            "customer_id": 0, ///新建时不需要传递,或者传0
            "name": "联系人昵称0310{{$date.timestamp}}",
            "email": "{{$date.timestamp}}@sdc.com",
            "tel": "",
            "tel_area_code": "86",
            "post_grade": 2,
            "post": "职位",
            // "qq": "",
            // "linkedin": "",
            // "skype": "",
            // "whatsapp": "",
            // "facebook": "",
            // "wechat": "",
            // "twitter": "",
            "birth": "2025-03-13",
            "gender": 1, //性别 男1 女
            "remark": "", //联系人备注
            "main_customer_flag": 0, //是否是主联系人 1:是 0:否
            "image_list": [],
            "351584883": 12,
            "351584919": [],
            "351584929": "2026-05-08 10:00:00",
            "1102611670": "多行文本本测试 嘻嘻哈哈",
            "1102611671": "剪刀",
            "1102611672": [
                "小美"
            ],
            "1102611675": 100,
            "1105746753": "文本字段",
            "3405202841": "2026-05-08 10:00:00",
            "3450371581": "3",
            "3450423112": "文本字段",
            "3450431094": "文本字段",
            "3555007283": [],
            "57664812592": "文本字段",
            "57236077114": "多行文本本测试\n嘻嘻哈哈111122",
            "57236076922": "文本字段"
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-sandbox.xiaoman.cn/v1/company/push/customer' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "company_id": 352023380, //新建时不需要传递,或者传0
    "user_id": 11858711, //操作人ID
    "is_public": 1,
    "serial_id": "", //客户编号
    "name": "open-api+{{$date.millisecondsTimestamp}}", //客户名称
    "short_name": "客户简称+{{$location.street}}",
    "country": "CN",
    "province": "陕西省",
    "city": "西安市",
    "tel_area_code": "86",
    "tel": "18920938291",
    "fax": "",
    "group_id": 0, //客户分组ID
    "pool_id": 0, //公海分组ID
    "origin_list": [
        14
    ], //来源ID列表
    "trail_status": 0,
    "biz_type": "生产商", //客户类型 来自客户枚举接口
    "cus_tag": [
        0
    ], //客户标签 来自客户枚举接口
    "address": "地址{{$location.secondaryAddress}}", //详细地址
    "remark": "公司备注", //客户备注
    "homepage": "www.ali.com",
    "star": 4, //客户星级 来自客户枚举接口
    "intention_level": 1, //采购意向 来自客户枚举接口
    "annual_procurement": 0, //年采购额 来自客户枚举接口
    "timezone": 5, //时区 来自客户枚举接口
    "scale_id": 2, //规模 来自客户枚举接口
    "image_list": [],
    "317003909": "文本字段",
    "319333155": "文本字段",
    "319354587": "文本字段",
    "319357955": "A",
    "348142520": "文本字段",
    "348159705": "多行文本本测试 嘻嘻哈哈",
    "348160052": "选项一",
    "348174646": "2026-05-08",
    "348174892": 100,
    "348175131": [],
    "348175368": [
        "选项一"
    ],
    "348175638": "2026-05-08 10:00:00",
    "348175873": 0.5,
    "348194943": "文本字段",
    "348195993": "文本字段",
    "348196009": "多行文本本测试 嘻嘻哈哈",
    "348196022": "选项一",
    "348196037": "2026-05-08",
    "348196049": 100,
    "348196054": [],
    "348196060": [
        "选项一"
    ],
    "348196066": "2026-05-08 10:00:00",
    "1101101837": "客户1-edit",
    "1101101838": "2026-05-08",
    "1101101839": 100,
    "1101101840": [
        "客户多选2-edit"
    ],
    "1101101841": "2026-05-08 10:00:00",
    "1102603643": "文本字段",
    "1105128163": "客户1-edit",
    "1105128171": "2026-05-08",
    "1105162749": "多行文本本测试 嘻嘻哈哈",
    "1514096184": "文本字段",
    "3082019289": "2026-05-08 10:00:00",
    "3455469523": "文本字段",
    "3493496861": "文本字段",
    "3493497310": "多行文本本测试 嘻嘻哈哈",
    "3493497316": "公司选项1",
    "3493497327": [
        "公司选项A"
    ],
    "3493497331": "2026-05-08",
    "3493497349": 100,
    "3493497372": [],
    "3493497382": "2026-05-08 10:00:00",
    "3555002419": [],
    "58218823169": "",
    "58214487467": "优质",
    "58199842716": "2026-05-08",
    "58161687747": "111",
    "57665595218": "文本字段",
    "57665415410": "2026-05-08 10:00:00",
    "57665401469": 0.5,
    "57665083623": "1",
    "57664468368": "多行文本本测试 嘻嘻哈哈",
    "57607745365": "多行文本本测试 嘻嘻哈哈",
    "57563952576": "文本字段",
    "57236146973": "多行文本本测试 嘻嘻哈哈",
    "57236146540": "文本字段",
    "57236146342": "文本字段",
    "57234714818": 100,
    "57234714792": 100,
    "57229828373": "文本字段",
    "57221915113": [
        "1"
    ],
    "57172556677": "2026-05-08",
    "55905073554": 0.5,
    "5218116642": [
        "客户下拉多选2"
    ],
    "next_follow_up_time": "2025-03-03 00:00:00", //下次跟进时间
    "category_ids": [
        [
            3
        ]
    ], //主营产品ID
    "product_group_ids": [], //产品分组ID
    "customers": [
        {
            "customer_id": 0, ///新建时不需要传递,或者传0
            "name": "联系人昵称0310{{$date.timestamp}}",
            "email": "{{$date.timestamp}}@sdc.com",
            "tel": "",
            "tel_area_code": "86",
            "post_grade": 2,
            "post": "职位",
            // "qq": "",
            // "linkedin": "",
            // "skype": "",
            // "whatsapp": "",
            // "facebook": "",
            // "wechat": "",
            // "twitter": "",
            "birth": "2025-03-13",
            "gender": 1, //性别 男1 女
            "remark": "", //联系人备注
            "main_customer_flag": 0, //是否是主联系人 1:是 0:否
            "image_list": [],
            "351584883": 12,
            "351584919": [],
            "351584929": "2026-05-08 10:00:00",
            "1102611670": "多行文本本测试 嘻嘻哈哈",
            "1102611671": "剪刀",
            "1102611672": [
                "小美"
            ],
            "1102611675": 100,
            "1105746753": "文本字段",
            "3405202841": "2026-05-08 10:00:00",
            "3450371581": "3",
            "3450423112": "文本字段",
            "3450431094": "文本字段",
            "3555007283": [],
            "57664812592": "文本字段",
            "57236077114": "多行文本本测试\n嘻嘻哈哈111122",
            "57236076922": "文本字段"
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 200,
    "message": "success",
    "now": "2019-10-12 14:47:33",
    "data": "success"
}
🟢200请求成功
修改于 2026-05-08 06:19:29
上一页
跟进动态查询接口
下一页
提交跟进动态