# Set up customer service avatar

Debugging Tools

Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide

Interface name: uploadkfhead img

This interface is used to set up customer service avatar

# 1. How to call

# HTTPS calls

POST https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KF_ACCOUNT

# Cloud Calls

This interface does not support cloud calls

# Third party invocation

This interface supports Third Party Platform generation business call.
This interface belongs to a permission set id of: 1,6,100-101
When a service provider is authorized by one of the permissions set, it can call on behalf of the merchant by using authorizer_access_token , which can be viewed in the third-party call documentation.

# 2. Request parameters

# Query parameters`Query String parameters`

Parameter Name	type	Required to fill in	Introductions
access_token	string	yes	Interface invocation credentials, using access_token , authorizer_access_token
kf_account	string	yes	Complete customer service account, format: account prefix @ Official Account WeChat

# Request Body`Request Payload`

Parameter Name	type	Required to fill in	Introductions
media	formdata	yes	Media file identification in form-data, filename, filelength, content-type and other information, file size within 5M

# 3. Return Parameters

# `Response Payload`

Parameter Name	type	Introductions
errcode	number	Error code
errmsg	string	Error message

# 4. Note

There are no special considerations for this interface

# 5. Code examples

Example Requests

curl -F media=@test.jpg "https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT"

Return an example

{
  "errcode": 0,
  "errmsg": "ok"
}

# 6. Error code

The following is a list of error codes for this interface, other error codes can refer to General error codes

Error code	Error Description	Solutions
-1	system error	The system is busy, so the developer is asked to try again in a few minutes.
40001	invalid credential access_token isinvalid or not latest	AppSecret error while getting access_token, or access_token is invalid.Developers should check that AppSecret is correct, or that they are calling interfaces for the appropriate Official Account
40005	invalid file type	The file format for uploading the material is not correct

# 7. Scope of application

How this interface can be invoked under different account types:

Official Account	Service Account
Certification only	Certification only

Authentication only: means that only authenticated accounts are allowed to be invoked by the enterprise entity, and accounts that are not authenticated or do not support authentication cannot be invoked.
Other account types that are not expressly stated may not be called on this interface without special instructions;