---
title: "Create Listing Statuses"
method: POST
path: "/listing/status"
tags: ["Listing"]
---

# Create Listing Statuses

`POST /listing/status`

## Request

- Base URL: `https://api.zentail.com/v1`
- URL: `https://api.zentail.com/v1/listing/status`
- Auth: API key in header `AUTHORIZATION`

This endpoint is restricted to developers who have registered an application with Zentail. Please refer to our [guide](https://developer.zentail.com/sales-channel-integration/getting-started) on building a sales channel integration to learn more about the registration process and how to use the listing endpoint.

## Request body

- ListingStatusPostData
  - `statuses` StatusItems[], required
    - `listing_id` string: The listing status Id
    - `sku` string, required: The product sku
    - `status` 'PUBLISHED' | 'UNPUBLISHED' | 'SUPPRESSED' | 'RETIRED', required: The status of the listing must be one of ['PUBLISHED', 'UNPUBLISHED', 'SUPPRESSED', 'RETIRED']
    - `channel_variant_id` string: A unique identifier for this variant on the channel
    - `channel_status` string: The raw status of the listing as reported by the channel
    - `listing_url` string: Location of the listing
    - `buyable` boolean, required: Whether the listing is buyable. This means it has inventory available and can be purchased on the channel.
    - `errors` ListingStatusError[], required: Any errors to display to the user
      - `severity` 'NOTICE' | 'WARNING' | 'ERROR', required
      - `classification` 'inventory' | 'images' | 'grouping' | 'listing_data' | 'other'
      - `affected_attributes` string[], required
      - `error` 'missing_value' | 'invalid_value' | 'restricted_value' | 'other'
      - `message` string, required

## Response `200`

Success

- ListingStatusResponse
  - `errors` ListingStatusErrorResponse[]
    - `listing_id` string
    - `sku` string
    - `messages` string[]

## Other responses

- `400`: Bad Request
- `403`: Permission Denied
- `404`: Not Found
- `500`: Zentail Error
- `503`: Zentail Error

---

[API](https://skmtc.dev/zentail/apis/zentail-api.md) - [All operations](https://skmtc.dev/zentail/apis/zentail-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zentail/apis/zentail-api/revisions/55e43cb43caf?raw)