---
title: "Create collection"
url: "https://earlyaccess.developers.bynder.com/apis/collections-api-1/versions/fa75179f-d3db-46c2-8693-3128e9d35db4/paths/api-v4-collections/post"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/collections-api-1/versions/fa75179f-d3db-46c2-8693-3128e9d35db4.md

# Create collection

`POST` `/api/v4/collections`

Create a new collection.

## Request body (required)

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

## Responses

- `201` - Created
- `400` - Bad Request
- `403` - Access denied

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Collections API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/collections:
    post:
      description: Create a new collection.
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              properties:
                description:
                  description: Collection description
                  example: Collection of featured assets
                  type: string
                name:
                  description: Collection name
                  example: Featured collection
                  type: string
              type: object
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Created
                    type: string
                  statuscode:
                    example: 201
                    type: integer
                type: object
          description: Created
          headers:
            Location:
              description: URL to the created collection
              schema:
                type: string
        "400":
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Collection name can't be empty
                    type: string
                  statuscode:
                    example: 400
                    type: integer
                type: object
          description: Bad Request
        "403":
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Access denied
                    type: string
                  statuscode:
                    example: 403
                    type: integer
                type: object
          description: Access denied
      security:
        - OAuth2:
            - COLLECTIONS
        - permanentToken:
            - COLLECTIONS
      summary: Create collection
      tags:
        - Collections
security:
  - OAuth2:
      - COLLECTIONS
  - permanentToken:
      - COLLECTIONS
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            COLLECTIONS: ""
            INBOXPUBLIC: To retrieve collections other users shared/received
            OUTBOXPUBLIC: To retrieve collections other users shared/received
            PUBLICCOLLECTIONS: To retrieve collections other users created
            PUBLISHCOLLECTIONS: ""
            SHARECOLLECTION: ""
            SHARING: ""
            collection.public.view: To retrieve public collections
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            COLLECTIONS: ""
            INBOXPUBLIC: To retrieve collections other users shared/received
            OUTBOXPUBLIC: To retrieve collections other users shared/received
            PUBLICCOLLECTIONS: To retrieve collections other users created
            PUBLISHCOLLECTIONS: ""
            SHARECOLLECTION: ""
            SHARING: ""
            collection.public.view: To retrieve public collections
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```