Create an IM directory group

Create an IM directory group under your account.

Scopes: imgroup:write:admin

Rate Limit Label: Light

请求参数

Body 参数multipart/form-data

name

string

可选

Group name: must be unique to one account.

<= 128 字符

search_by_account

boolean

可选

Members can search for others under same account.

search_by_domain

boolean

可选

Members can search for others in the same email domain.

search_by_ma_account

boolean

可选

Members can search for others under same master account, including all sub accounts.

type

enum<string>

可选

IM Group types:
normal - Only members can see automatically see the other members of this group. Other people can search for members within this group.
shared - Everyone under an account can see the group members automatically.
restricted - Nobody can see the group or search for members except the members in the group.

枚举值:

normalsharedrestricted

默认值:

normal

示例值:

normal

返回响应

🟢200**Error Code:** `200` Only available for paid account:{accountId}.

application/json

Body

object {0}

🟢201**HTTP Status Code:** `201` IM Group created.

🟠404**HTTP Status Code:** `404` **Error Code:** `4130` Group does not exist:{groupId}.

🟠409**HTTP Status Code:** `409` **Error Code:** `4132` Group name {groupName} is already in use.