Skip to main content

Invite to Group

Brief Description

  • Invite user to group. Whether user can be pulled into the group is determined by the join group setting. If verification is required, group owner or group admin need to agree to proceed.

Request Method

  • post

Request URL

  • {API_ADDRESS}/group/invite_user_to_group
Header NameExample ValueOptionalTypeDescription
operationID1646445464564RequiredstringUsed for global link tracking, timestamp is recommended, independent in each request
tokeneyJhbxxxx3XsRequiredstringAdmin token

Request Parameter Example

{
"groupID": "2759960147",
"invitedUserIDs": [
"1225441072",
"9906953281"
],
"reason": "your reason"
}
Field NameOptionalTypeDescription
groupIDRequiredstringGroup ID
invitedUserIDsRequiredarrayInvited user ID list
reasonOptionalstringInvite reason

Success Return Example

{
"errCode": 0,
"errMsg": "",
"errDlt": ""
}

Parameter Description for Success Return Example

Parameter NameTypeDescription
errCodeintError code, 0 means successful
errMsgstringBrief error message, empty
errDlterrDltDetailed error message, empty
dataobjectGeneric data object, specific structure is below

Failure Return Example

{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}

Parameter Description for Failure Return Example

Parameter NameTypeDescription
errCodeintError code, specifically check the global error code document
errMsgstringBrief error message
errDlterrDltDetailed error message