POST
/
applications
/
{app}
/
groups
curl --request POST \
  --url https://api.rownd.io/applications/{app}/groups \
  --header 'Content-Type: application/json' \
  --header 'x-rownd-app-key: <api-key>' \
  --header 'x-rownd-app-secret: <api-key>' \
  --data '{
  "name": "My Teammates",
  "admission_policy": "invite_only",
  "meta": {}
}'
{
  "id": "group_a3l1n2lsnb3q0xbul9enjnh7",
  "name": "My Teammates",
  "member_count": 0,
  "app_id": "327677849595019856",
  "admission_policy": "invite_only",
  "meta": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "updated_by": "user_t6ftnnmw55pamuhfo9xvw0yl",
  "created_by": "user_t6ftnnmw55pamuhfo9xvw0yl"
}

Authorizations

​
x-rownd-app-key
string
header
required

The publishable key of your application credentials. (more details)

​
x-rownd-app-secret
string
header
required

The private secret of your application credentials. (more details)

Path Parameters

​
app
string
required

Rownd application ID

Body

application/json
​
name
string

The group name

Example:

"My Teammates"

​
admission_policy
enum<string>
default:invite_only

Set whether the group be open for anyone to join or by invite only

Available options:
invite_only,
open
Example:

"invite_only"

​
meta
any | null

An object containing additional metadata for the group

Response

200 - application/json
Group created successfully
​
id
string

The group ID

Example:

"group_a3l1n2lsnb3q0xbul9enjnh7"

​
name
string

The group name

Example:

"My Teammates"

​
member_count
number
default:0
deprecated

This value is no longer provided by the API. The default value of 0 will always be returned

​
app_id
string

Rownd application ID

Example:

"327677849595019856"

​
admission_policy
enum<string>
default:invite_only

Set whether the group be open for anyone to join or by invite only

Available options:
invite_only,
open
Example:

"invite_only"

​
meta
any | null

An object containing additional metadata for the group

​
created_at
string

The ISO 8601 date-time that the resource was created

​
updated_at
string

The ISO 8601 date-time that the resource was updated

​
updated_by
string

The ID of the user that created the resource

Example:

"user_t6ftnnmw55pamuhfo9xvw0yl"

​
created_by
string

The ID of the user that most recently updated the resource

Example:

"user_t6ftnnmw55pamuhfo9xvw0yl"

OverviewRetrieve a group