curl --request POST \
  --url https://web-api.dev.soxai.site/api/groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "groupName": "Family",
  "displayName": "Jane",
  "sharedFields": {
    "sleep_score": true
  }
}
'

import requests

url = "https://web-api.dev.soxai.site/api/groups"

payload = {
    "groupName": "Family",
    "displayName": "Jane",
    "sharedFields": { "sleep_score": True }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({groupName: 'Family', displayName: 'Jane', sharedFields: {sleep_score: true}})
};

fetch('https://web-api.dev.soxai.site/api/groups', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "groupId": "b7d1f0c9a2e4d6f8b0c1",
  "groupName": "Shibata family",
  "groupType": "family",
  "createdBy": "user123",
  "createdAt": "2026-08-03T09:30:00+00:00",
  "status": "active"
}

{
  "error": "bad-request",
  "error_msg": "Invalid input: <reason>"
}

{
  "error": "http-error",
  "error_msg": "Invalid authentication credentials. <reason>"
}

{
  "error": "forbidden",
  "error_msg": "Not enough permission"
}

{
  "error": "conflict",
  "error_msg": "a user can belong to at most 20 groups"
}

{
  "error": "unprocessable-entity",
  "error_msg": "body.<field>: <validation message>"
}

{
  "error": "rate-limited",
  "error_msg": "Rate limit exceeded. Retry after <n> seconds."
}

{
  "error": "internal-server-error",
  "error_msg": "Failed to fetch data: <error_message>"
}