> ## Documentation Index
> Fetch the complete documentation index at: https://docs.covver.io/llms.txt
> Use this file to discover all available pages before exploring further.

> Automatically create a branded collection from a logo

# Create a new collection

<Tip>
  Use this API if you want to create the collections via API.
  You could also create them manually from your partner dashboard
</Tip>

<Tip>
  Store creation takes about 30 seconds. Use the [Get collection status](/api-reference/designs/get-collection-status) API to poll for the status
</Tip>

<Tip>
  Omit companyId if you want to create a new company as well
</Tip>


## OpenAPI

````yaml post /api/ext/v1/collection
openapi: 3.0.1
info:
  title: Covver External API docs
  description: Covver External API docs
  version: 0.1.0
servers:
  - url: https://staging-api.covver.io
    description: Covver Staging Server
  - url: https://api.covver.io
    description: Covver Production Server
  - url: http://localhost:8080
    description: Covver Local Server
security:
  - BearerAuth: []
tags:
  - name: Auth
    description: Authentication endpoints
  - name: Products
    description: Product endpoints
  - name: People
    description: People endpoints
  - name: Orders
    description: Orders endpoints
  - name: Reports
    description: Report endpoints
externalDocs:
  url: https://swagger.io
  description: Find more info here
paths:
  /api/ext/v1/collection:
    post:
      tags:
        - Collections
      summary: Create a new collection
      description: Create a new collection from a logo
      parameters:
        - schema:
            type: string
          in: query
          name: companyId
          required: false
        - schema:
            type: string
          in: query
          name: logoUrl
          required: false
          description: >-
            Use this field instead of a multipart file to specify a URL to pull
            the Logo from. This should be a high-res PNG or SVG
        - schema:
            enum:
              - Coins
              - Gifts
            default: Coins
          in: query
          name: storeType
          required: false
          description: >-
            Credit/points stores display prices in credits/points (1 c/p = 1
            USD). Every user is allocated with credits/points to spend in the
            store. Gift stores hide prices, and each user is allocated with an
            amount of items they can order
        - schema:
            enum:
              - GENERAL
              - BACK TO SCHOOL
              - ECO
              - SPORT
              - SUMMER
              - HATS
              - WINTER_SNOW
              - HOLIDAYS_SNOW
              - PRIDE
              - SNAPPY
            default: GENERAL
          in: query
          name: theme
          required: false
        - schema:
            enum:
              - 'true'
              - 'false'
          in: query
          name: allowPaymentCheckout
          required: false
          description: >-
            Payment checkout allows store users to top-up missing store
            credits/points with a credit card during checkout. This option is
            only availble in Credit/Points stores
        - schema:
            type: string
          in: query
          name: firstName
          required: false
        - schema:
            type: string
          in: query
          name: lastName
          required: false
        - schema:
            type: string
          in: query
          name: department
          required: false
        - schema:
            type: string
          in: query
          name: location
          required: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                files:
                  description: Multipart file upload
                  type: object
                  properties:
                    buffer: {}
                    mimetype:
                      enum:
                        - image/png
                        - image/jpeg
                        - image/webp
                        - image/svg+xml
                        - application/json
                        - image/vnd.adobe.photoshop
                        - text/csv
                        - application/pdf
                    encoding:
                      type: string
                    filename:
                      type: string
                  required:
                    - buffer
                    - mimetype
                    - encoding
                    - filename
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  companyId:
                    type: string
                  companySlug:
                    type: string
                  collectionId:
                    type: string
                required:
                  - companyId
                  - companySlug
                  - collectionId
        4XX:
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  errorCode:
                    type: string
                  error: {}
                  statusCode:
                    type: number
                required:
                  - message
                  - errorCode
                  - statusCode
        5XX:
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  errorCode:
                    type: string
                  error: {}
                  statusCode:
                    type: number
                required:
                  - message
                  - errorCode
                  - statusCode
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````