---
title: "Create user"
url: "https://earlyaccess.developers.bynder.com/apis/users-1/versions/81ec58a1-c748-4616-b383-861ec1c98a2d/paths/api-v4-users/post"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/users-1/versions/81ec58a1-c748-4616-b383-861ec1c98a2d.md

# Create user

`POST` `/api/v4/users/`

## Request body (required)

Content types: `application/x-www-form-urlencoded`

## Responses

- `201` - User created

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Users
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/users/:
    post:
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: "#/components/schemas/User"
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                properties:
                  id:
                    type: string
                  username:
                    type: string
                type: object
          description: User created
      security:
        - permanentToken:
            - USERMANAGEMENT
        - OAuth2:
            - USERMANAGEMENT
      summary: Create user
      tags:
        - Users
security:
  - permanentToken:
      - USERMANAGEMENT
  - OAuth2:
      - USERMANAGEMENT
components:
  schemas:
    User:
      properties:
        active:
          default: 1
          enum:
            - 1
            - 0
          type: integer
        companyName:
          type: string
        costCenter:
          type: string
        department:
          type: string
        email:
          type: string
        firstname:
          type: string
        groupIds:
          type: string
        infix:
          type: string
        isSSOOnly:
          default: false
          type: boolean
        job:
          type: string
        language:
          type: string
        lastname:
          type: string
        password:
          type: string
        phoneNumber:
          type: string
        profileId:
          type: string
        username:
          type: string
      required:
        - password
        - email
        - profileId
        - firstname
        - lastname
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            USERMANAGEMENT: Grants permission to manage users
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            USERMANAGEMENT: Grants permission to manage users
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```