Skip to main content
POST
/
v2
/
groups
Create or Update Group
curl --request POST \
  --url https://api.village.do/v2/groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "group_id": "<string>",
  "logo": "<string>"
}
'
{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "logo": "<string>",
    "invite_link": "<string>"
  },
  "metadata": {
    "request_id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Use the API token from your personal Village account: https://village.do/settings#api-keys

For verified apps accessing user data, create a user token: https://docs.village.do/api-reference-v2/authentication/create-authorization

Body

application/json

Request body for creating or updating a group

​
name
string
required
Required string length: 1 - 100
​
group_id
string
Minimum string length: 1
Minimum string length: 1

Response

Group created or updated successfully

​
data
object
required

Response after creating or updating a group

​
metadata
object
required