Skip to main content
POST
/
vendor
/
offers
curl -X POST 'http://localhost:9000/vendor/offers' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sku": "ACME-SHIRT-M",
    "variant_id": "variant_01HXYZ",
    "shipping_profile_id": "sp_01HXYZ",
    "prices": [{ "amount": 2500, "currency_code": "usd" }],
    "inventory_items": [
      {
        "required_quantity": 1,
        "stock_levels": [{ "location_id": "sloc_01HXYZ", "stocked_quantity": 100 }]
      }
    ]
  }'

{
  "offer": {
    "id": "offer_01HXYZ",
    "seller_id": "sel_01HXYZ",
    "variant_id": "variant_01HXYZ",
    "product_id": "prod_01HXYZ",
    "shipping_profile_id": "sp_01HXYZ",
    "sku": "ACME-SHIRT-M",
    "prices": [
      { "id": "price_01HXYZ", "amount": 2500, "currency_code": "usd" }
    ],
    "inventory_items": [
      { "inventory_item_id": "iitem_01HXYZ", "required_quantity": 1 }
    ]
  }
}
Creates the seller’s offer for a variant — the seller’s SKU, shipping profile, prices, and backing inventory.
A product can be listed by many sellers; the offer is what carries the seller’s own price and stock for a variant.

​
Query parameters

​
fields
string
Comma-separated fields to include in the returned offer. Prefix with +/- to add to or remove from the defaults.

​
Body parameters

​
sku
string
required
The seller’s SKU for this listing.
​
variant_id
string
required
ID of the product variant being listed.
​
shipping_profile_id
string
required
ID of the seller’s shipping profile used to fulfill the offer.
​
inventory_items
object[]
required
Inventory items backing the offer; at least one is required.
​
prices
object[]
required
Offer prices; at least one is required.
​
ean
string
EAN barcode.
​
upc
string
UPC barcode.
​
metadata
object
Custom key-value pairs.

​
Response

​
offer
object
curl -X POST 'http://localhost:9000/vendor/offers' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sku": "ACME-SHIRT-M",
    "variant_id": "variant_01HXYZ",
    "shipping_profile_id": "sp_01HXYZ",
    "prices": [{ "amount": 2500, "currency_code": "usd" }],
    "inventory_items": [
      {
        "required_quantity": 1,
        "stock_levels": [{ "location_id": "sloc_01HXYZ", "stocked_quantity": 100 }]
      }
    ]
  }'

{
  "offer": {
    "id": "offer_01HXYZ",
    "seller_id": "sel_01HXYZ",
    "variant_id": "variant_01HXYZ",
    "product_id": "prod_01HXYZ",
    "shipping_profile_id": "sp_01HXYZ",
    "sku": "ACME-SHIRT-M",
    "prices": [
      { "id": "price_01HXYZ", "amount": 2500, "currency_code": "usd" }
    ],
    "inventory_items": [
      { "inventory_item_id": "iitem_01HXYZ", "required_quantity": 1 }
    ]
  }
}