---
title: "Create group"
url: "https://earlyaccess.developers.bynder.com/apis/workflow-users-and-groups-api-1/versions/95f38e13-7691-49d0-80f0-875f3802be91/paths/api-workflow-groups/post"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/workflow-users-and-groups-api-1/versions/95f38e13-7691-49d0-80f0-875f3802be91.md

# Create group

`POST` `/api/workflow/groups/`

## Request body (required)

Content types: `application/json`

## Responses

- `200` - Group created

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Workflow Users and Groups API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/workflow/groups/:
    post:
      requestBody:
        content:
          application/json:
            schema:
              properties:
                name:
                  example: new name
                  type: string
                user_ids:
                  items:
                    example: 00000000-0000-0000-0000-000000000000
                    type: string
                  type: array
              type: object
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                type: object
          description: Group created
      security:
        - permanentToken:
            - GROUPOVERVIEW
            - WORKFLOWADMIN
        - OAuth2:
            - GROUPOVERVIEW
            - WORKFLOWADMIN
      summary: Create group
      tags:
        - Groups
security:
  - permanentToken:
      - GROUPOVERVIEW
      - WORKFLOWADMIN
  - OAuth2:
      - GROUPOVERVIEW
      - WORKFLOWADMIN
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            GROUPOVERVIEW: ""
            USERMANAGEMENT: ""
            WORKFLOWADMIN: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            GROUPOVERVIEW: ""
            USERMANAGEMENT: ""
            WORKFLOWADMIN: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```