---
title: "Create a new listing"
method: POST
path: "/selling/listings"
tags: ["Listings"]
---

# Create a new listing

`POST /selling/listings`

## Request

- Base URL: `https://api.stockx.com/v2`
- URL: `https://api.stockx.com/v2/selling/listings`
- Auth: API key in header `x-api-key` and HTTP bearer

Create listings API allows you to create new listings.
The listings correspond to an ask in the StockX UI. The listings can be for the same variant ID.

## Request body

- CreateListingInput
  - `amount` string, required: The amount this product is being listed for
  - `variantId` string, required: Unique StockX variant ID that this listing is being created for
  - `currencyCode` string: The currency code this product is being listed in. If not provided, it will default to USD. Only valid currencies supported on stockx.com are supported via API<br><br>Available values: "AUD", "CAD", "CHF", "EUR", "GBP", "HKD", "JPY", "KRW", "MXN", "NZD", "SGD", "USD"
  - `expiresAt` string: UTC timestamp representing when this Ask should auto-expire. If not provided, it will default to 999 days from today. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `active` boolean: A flag that defaults to true, activating the listing on the StockX marketplace
  - `inventoryType` string: The inventory this product is being listed in. If not provided, it will default to STANDARD.<br><br>Available values: "STANDARD", "DIRECT"

## Response `201`

Created

- ListingAsyncOperationResponse
  - `listingId` string, required: Unique ID for this listing
  - `operationId` string, required: Unique ID for this operation
  - `operationType` 'CREATE' | 'UPDATE' | 'DELETE' | 'ACTIVATE' | 'DEACTIVATE' | 'CANCEL_ORDER' | 'RECLAIM' | 'CANCEL_RECLAIM' | 'TPS_CHECK', required
  - `operationStatus` 'PENDING' | 'SUCCEEDED' | 'FAILED', required
  - `operationUrl` string, nullable, required: The URL used for to poll the status of the operation.
  - `operationInitiatedBy` 'USER' | 'SYSTEM', required
  - `operationInitiatedVia` 'IOS' | 'ANDROID' | 'WEB' | 'STOCKX-PRO' | 'SCOUT' | 'SHOPIFY' | 'PUBLIC-API' | 'INTERNAL-SYSTEM', required
  - `createdAt` string, required: When the listing was created in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `updatedAt` string, required: When this listing was last updated in UTC. Represented as ISO 8601 format like 2021-11-09T12:44:31.000Z
  - `changes` ListingOperationsChangesDiff, required: JSON metadata object which include the changes of current listing
    - `additions` AdditionsRecursivePartialListingChangeableFields, required: The additions of current listing
    - `updates` UpdatesRecursivePartialListingChangeableFields, required: The updates of current listing
    - `removals` RemovalsRecursivePartialListingChangeableFields, required: The removals of current listing
  - `error` string, nullable: Error message if the creation failed

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/stockx/apis/stockx-public-api.md) - [All operations](https://skmtc.dev/stockx/apis/stockx-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stockx/apis/stockx-public-api/revisions/2d70f6b5d01b?raw)