---
title: "Create a new package (marketplace content item)"
method: POST
path: "/packages"
tags: ["packages"]
---

# Create a new package (marketplace content item)

`POST /packages`

## Request

- Base URL: `https://pmp-demo.privateplatform.mendix.com/marketplaceservice/v1`
- URL: `https://pmp-demo.privateplatform.mendix.com/marketplaceservice/v1/packages`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

### Use the POST method as a first step to create a new content item.

Note the following:
- This operation will create a new package in marketplace and an initial 1.0.0 version if no version specified.
- The Status of the initial version of package will be Draft.

## Request body

- PackageInput: Package creation request
  - `name` string, required: Package name.
  - `description` string, required: Package description.
  - `studioProVersion` string, required: Studio pro version that package support.
  - `appContentTypeName` string, required: Package content type name.
  - `ownerGroupName` string: Package owner group name.
  - `license` string, required: License name for package.
  - `logoFile` string, required: Base64EncodedContent string of package version logo file.
  - `visibility` string: Package is visible to all or only specific groups.
  - `versionMajor` integer: Package first version major number.
  - `versionMinor` integer: Package first version minor number.
  - `versionPatch` integer: Package first version patch number.
  - `releaseNotes` string, required: Package release note text.
  - `documentation` string: Package documentation text.
  - `screenshotInputs` object[]: Package screenshot file.
    - `base64EncodedContent` string: Base64EncodedContent string of package screenshot file.
    - `fileName` string: Package screenshot file name.
  - `sourceFileInput` object, required: Package source mpk file.
    - `base64EncodedContent` string, required: Base64EncodedContent string of package source mpk file.
    - `fileName` string, required: Package source mpk file name.
  - `appCategories` object[]: Package App Category.
    - `name` string: Package App Category name.

## Response `201`

Package response

- object
  - `id` integer
  - `name` string
  - `appContentTypeName` string
  - `ownerUserName` string
  - `ownerGroupName` string
  - `status` string
  - `visibility` string
  - `downloads` integer
  - `appCategories` object[]: Package App Category.
    - `name` string: Package App Category name.
  - `version` object
    - `id` string
    - `name` string
    - `description` string
    - `versionNum` string
    - `versionMajor` integer
    - `versionMinor` integer
    - `versionPatch` integer
    - `supportedStudioPro` string
    - `defaultVersion` boolean
    - `versionStatus` string
    - `logoUrl` string
    - `appViewUrl` string
    - `appDownloadUrl` string
    - `fileName` string
    - `releaseNotes` string
    - `documentation` string
    - `license` string
    - `supportLevel` string
    - `organisationName` string

## Other responses

- `400`: Invalid input parameter or request body
- `401`: Authentication information missing or invalid
- `403`: No permission for this operation
- `404`: Resource not found

---

[API](https://skmtc.dev/mendix/apis/marketplace-service.md) - [All operations](https://skmtc.dev/mendix/apis/marketplace-service/llms.txt) - [OpenAPI document](https://skmtc.dev/mendix/apis/marketplace-service/revisions/8b2faa028606?raw)