Create Group API

Create a group

post

/groups

Create a group. The created group is returned with 201 Created.

Authorizations

user-api-keystringRequired

API key for programmatic access, sent in the user-api-key header.

Body

Request body accepted when creating a group.

Responses

201

201 Created response wrapping a resource body.

application/json

JSON:API document wrapping a single resource.

400

The request body could not be parsed as JSON.

application/json

401

Authentication credentials are missing or invalid.

application/json

422

The request body failed validation.

application/json

post/groups

POST /api/v1/groups HTTP/1.1
Host: app.channex.io
user-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "group": {
    "title": "User Group"
  }
}

{
  "data": {
    "type": "group",
    "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
    "attributes": {
      "id": "f71f6a62-d49a-4f2f-ae90-4f81d347ff67",
      "title": "User Group"
    },
    "relationships": {
      "properties": {
        "data": [
          {
            "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
            "type": "property",
            "attributes": {
              "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
              "title": "Property 1"
            }
          }
        ]
      },
      "users": {
        "data": [
          {
            "type": "user",
            "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
            "attributes": {
              "id": "716305c4-561a-4561-a187-7f5b8aeb5920",
              "name": "Channex User",
              "email": "[e-mail]"
            }
          }
        ]
      }
    }
  }
}