添加企业联系人

添加一个新的企业联系人。

请求 URL

POST {base_url}/{api_path}/company_contact/create?access_token={access_token}

请求参数

表 1.
参数 是否必填 类型 说明
first_name 是 String 名称。
last_name 否 String 姓氏。
company 否 String 公司。
email 否 String 邮箱。
phonebook_id_list 否 Array<Integer> 所属企业联系人群组的唯一 ID。
注：
remark 否 String 备注。
number_list 是 Array<Number_List> 企业联系人号码列表。
zip_code 否 String 邮政编码。
street 否 String 街道。
city 否 String 城市。
state 否 String 州（省）。
country 否 String 国家。
Number_List
表 2.
参数 类型 说明
num_type String 号码类型。
  • business_number：办公号码
  • business_number2：办公号码 2
  • business_fax： 公司传真
  • mobile_number：手机号码
  • mobile_number2：手机号码 2
  • home_number：家庭号码
  • home_number2：家庭号码 2
  • home_fax：家庭传真
  • other_number：其他号码
number String 号码。

响应参数

表 3.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
id Integer 企业联系人的唯一 ID。

示例

请求示例

POST /openapi/v1.0/company_contact/create?access_token=vtkE9as9ILt8D7zd20beBzd8dL2uTcOL HTTP/1.1  

Host: yeastardocs.example.yeastarcloud.com
Content-Type: application/json
{
    "first_name": "Example",
    "last_name": "Li",
    "company": "Demo",
    "email": "liexample@icloud.com",
    "phonebook_id_list": [
        5,6
    ],
    "remark": "contact_for_test",
    "zip_code": "361022",
    "street": "Software Park III",
    "city": "Xiamen",
    "state": "",
    "country": "China",
    "number_list": [
        {
            
            "num_type": "business_number",
            "number": "12333333"
        }
    ]
}

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "id": 31
}