Create group

post

https://miro.com/api/v1/scim/Groups

Creates a new Miro user group in the organization.

Note: The displayName must be unique within the organization. The maximum length of the displayName is 60 characters; longer values are truncated.

You can optionally provide an initial list of members. Adding members follows the same rules as the add operation in Patch group.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Payload to create a new Miro user group.

schemas

array of strings

Identifies which schema(s) this resource uses. In this case, it is the SCIM core Group schema.

schemas

Allowed:

displayName

string

required

A human-readable name for the group (user group). Must be unique within the organization.

Maximum length: 60 characters. Longer values are truncated.

members

array of objects

An optional list of users to add as initial members of the user group.

Adding members follows the same rules as the Patch group add members operation.

members

Headers

string

enum

Defaults to application/scim+json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/scim+json

Generated from available request content types

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/scim+json

application/json

201Successful Operation

400Malformed request Conditions: - If the displayName is missing or invalid, the user group cannot be created. - If a member to be added does not exist or is not part of the organization, the user group cannot be created.

401Invalid authentication credentials

403Invalid access

404Not Found

409Conflict Conditions: - If a user group with the same displayName already exists in the organization, the user group cannot be created.

413Payload too large or contains too many items

429Too many requests.

500Internal Server Error