---
title: "Create Offer"
method: POST
path: "/v1/seller/offer"
tags: ["Offer"]
---

# Create Offer

`POST /v1/seller/offer`

## Request body

- ProductOfferList — Batch of product offers (product master data plus per-channel offer data) to be created or updated.
  - `offerList` Offer[], required
    - `salesChannelOfferList` object[], required
      - `channel` string, required — This is the unique Channel name.
      - `sellerId` string, required — A unique Id identify a Seller on a specific SalesChannel. The SellerId is generated from the Channel itself during the Seller SignUp Process.
      - `offerId` integer, required — Unique Offer Id to identify an Offer on a Sales Channel.
      - `parentOfferId` integer, nullable — In case the current offer has an reference to a parent offer. This ParentOfferId must be used to identify the Parent Offer. The ParentOfferId is conditionally mandatory for variation Offers in case you add a new Item to a existing Variation Offer Listing.
      - `channelOfferId` string — Channel defined unique Offer Id to identify an Offer on a Sales Channel.
      - `channelCategoryId` string
      - `quantity` string — Offer Quantity
      - `taxPercent` string
      - `priceList` PriceContainer[], required
        - `id` string, required
        - `quantityPriceList` QuantityPrice[], required
          - `amount` string, required
          - `currency` string, required
          - `quantity` string, nullable
      - `title` string — Title used for this specific SalesChannel. If no title is provided, the product title should be used.
      - `subTitle` string — Subtitle used for this specific SalesChannel. If no subtitle is provided, the product description should be used.
      - `description` string — Description used for this specific SalesChannel. If no description is provided, the product description should be used.
      - `mainPicture` string
      - `pictureList` string[]
      - `channelAttributeList` ChannelAttribute[] — A List of SalesChannel related attributes. Typically all required attributes need to be passed through this objects. Required (and also optional) attributes can be requested using the /meta Data API endpoints.
        - `attributeId` string, required
        - `value` string, required
        - `group` string, nullable
      - `variationList` Variation[]
        - `offerId` integer, required — Unique Offer Id to identify an Offer on a Sales Channel.
        - `sku` string, required — Stock keeping unit is a unique Id used to identify one product.
        - `gtin` string
        - `variationDimensionList` ChannelAttribute[], required — A List of SalesChannel related attributes. These attributes are used to define variation dimensions. You can use up to 10 dimensions to build a multi-variation listing.
          - `attributeId` string, required
          - `value` string, required
          - `group` string, nullable
        - `quantity` string, required — Offer Quantity
        - `priceList` PriceContainer[], required
          - `id` string, required
          - `quantityPriceList` QuantityPrice[], required
            - `amount` string, required
            - `currency` string, required
            - `quantity` string, nullable
        - `taxPercent` string
        - `pictureList` string[]
        - `title` string — Title used for this variation listing on SalesChannel. If no title is provided, the SalesChannelOffer title should be used.
        - `subTitle` string — Subtitle used for this variation listing on SalesChannel. If no subtitle is provided, the SalesChannelOffer Subtitel should be used.
        - `description` string — Description used for this variation listing on SalesChannel. If no description is provided, the SalesChannelOffer description should be used.
        - `channelAttributeList` ChannelAttribute[] — A List of SalesChannel related attributes. Typically all required attributes need to be passed through this objects. Required (and also optional) attributes can be requested using the /meta Data API endpoints. A Channel should merge the SalesChannelOffer channelAttributeList with this Attribute List. This List extends the Attributes from the SalesChannelOffer channelAttributeList property and should be overwrite existing Attributes.
          - `attributeId` string, required
          - `value` string, required
          - `group` string, nullable
    - `product` Product, required
      - `sku` string, required — Stock keeping unit is a unique Id used to identify one product.
      - `title` string
      - `subTitle` string
      - `description` string
      - `gtin` string
      - `mpn` string
      - `isbn` string
      - `brand` string
      - `srp` Price
        - `amount` string, required
        - `currency` string, required
      - `productAttributeList` ProductAttribute[]
        - `name` string, required
        - `value` string, required

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Access forbidden, invalid or unknown Token was used.
- `429` — User has send to many requests
- `500` — Unexpected Server Error

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)