Create a group

Create a group with required members to start a group conversation using below API.

info

{api-base-url} can be obtained from the MirrorFly console.

HTTP request

curl -X POST "https://{api-base-url}/api/v1/group/group"

-H "accept: */*"

-H "Authorization: xxxxxxxxxxxxxxxxxx"

-H "Content-Type: application/json"

-d "{ \"licenseKey\": \"samplelicenseKey\", \"groupName\": \"samplegroupname\", \"groupImageUrl\": \"sampleurl\", \"groupMembers\": [{\"isAdmin\": true/false, \"userId\": \"77xxxxxx22\"}]}"

Request Params

Param	DataType	Required	Description
groupName	String	Yes	A name for this group
groupImageUrl	String	No	Group profile picture url
groupMembers	Array of objects	Yes	List of members to be added to this group
groupMembers.isAdmin	boolean	No	Whether to add this member as admin default value is false
groupMembers.userId	String	Yes	UserId of the member to be added
licenseKey	String	Yes	Licensekey for this group

Responses

If successful, this action creates a group and adds provided members to it.

{

"status": 200,

"data": {

"groupId": "xxxxxxxxxx", // String - group id - autogenerated

"groupName": "samplegroupname"// String - group name

},

"message": "Group created successfully"

}

Error

In the case of an error, an error object like below is returned.

When the token passed in Headers is expired

{

"status": 401,

"message": "Token Expired"

}

In the case of a Bad Request, an error message is returned

{

"status": 400,

"message": "Error Message"

}