HTTP Group Create


Required Fields


memberIds
A JSON list of Identity IDs who will be the members of the Group. Identity IDs can be retrieved by querying the Identity API endpoint

Optional Fields


displayName
A descriptive name for the Group
description
Further information used to describe the Group

Request


POST https://api.flowthings.io/v0.1/<account_id>/group

Headers

NameDescription
Content-Typeapplication/json
X-Auth-TokenAuthentication Token

Example

{
  "displayName": "Research Team",
  "description": "Members of Project Team Y working on the new release",
  "memberIds": [
    "i5488db43d4c63a633ad84bcc",
    "i5489e275d4c6f62700be9fd6"
  ]
}

Response


HTTP Codes

CodeDescription
201Resource Created
400Bad Request
401Unauthorized
503Service Unavailable

Example Response Body

{
  "head": {
    "status": 201,
    "ok": true,
    "messages": [
      "Your request has been processed successfully. A new resource has been created."
    ],
    "errors": []
  },
  "body": {
    "id": "g5489f22ed4c66f8dfcbe2794",
    "creationDate": 1409455732680,
    "displayName": "Research Team",
    "description": "Members of Project Team Y working on the new release",
    "memberIds": [
      "i5488db43d4c63a633ad84bcc",
      "i5489e275d4c6f62700be9fd6"
    ]
  }
}