Skip to main content

Create Organization Groups

POST 
/iot/pub/v1/organization

Create one or more groups in the organization hierarchy. Send one group, or an array of up to 1000 groups.
A parent can be an existing group or a group listed earlier in the same request, so several levels can be created in one request: list each parent before its children. An empty, null or omitted parent creates the group directly under the top-level group.
Group names are unique in a tenant. The hierarchy can be at most five levels deep, counting the top-level group.
The request is all or nothing: if any group is rejected (for example a name that is already used, a parent that does not exist or is listed after its child, or a group that would be too deep), the request returns HTTP 400 and no group is created.
For customers using the IoT Standalone Portal, refer to IoT Standalone Public API Authentication page.

Request​

Responses​

Groups Successfully Created