Add Product to sales channels

Event GroupEvent Identification
product_listingsproduct_listings/add
Add Product to sales channels
Request Headers
  • X-Shopline-Topic string required
    The unique identifier for the event.
    Example: orders/edited
  • X-Shopline-Hmac-Sha256 string required
    The signature of the request. Upon receiving the request, you must verify the signature to confirm the authenticity and integrity of the data.
    Example: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
  • X-Shopline-Shop-Domain string required
    The store domain.
    Example: example.myshopline.com
  • X-Shopline-Shop-Id string required
    The store ID.
    Example: 1610418123456
  • X-Shopline-Merchant-Id string required
    The merchant ID.
    Example: 2000001234
  • X-Shopline-API-Version string required
    The API version.
    Example: v20250601
  • X-Shopline-Webhook-Id string required
    The ID of this Webhook event.
    Example: b54557e48a5fbf7d70bcd043
Request Body
  • product_listingobject
    Product information
  • body_html string
    Product description
    Example: This is a description
  • created_at string
    Product create time
    Example: 2023-03-02T18:18:42.883+0800
  • handle string
    Global unique Product handle
    Example: proudct-handle
  • id string
    Product ID
    Example: 16058287356753559620272670
  • imagesobject[]
    Product main image listing
  • alt string
    Picture alt
    Example: This is a image alt
  • src string
    Image URL
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • optionsobject[]
    Option list
  • id string
    Option id
    Example: 16158288104774469113452670
  • name string
    Option name
    Example: Color
  • option_valuesobject[]
    List of option values.
  • id string
    The ID of option value.
    Example: 16247051995358890915900034
  • value string
    The option value.
    Example: Red
  • product_id string
    Duiying id corresponding
    Example: 16058287356753569620272670
  • values array
    List of options value
    Example: ["[\"Red\", \"Green\", \"White\"]"]
  • values_images map
    Option value chart
    Example: {}
  • product_behavior string
    Product behavior
    Example: RISK,HIDDEN
  • product_category string
    Product polymer type
    Example: Electronic
  • product_type string
    Product type
    Example: Electronic
  • published_at string
    Time to post to online stores
    Example: 2023-03-02T18:18:42.883+0800
  • published_scope string
    Launch range , " web " means online stores
    Example: web
  • spu string
    Size s pu
    Example: S000000001
  • status string
    Product status : active- on shelf , draft- off shelf , archived- filing
    Example: active
  • subtitle string
    Product summary
    Example: This is a subtitle
  • tags string
    Tag , multiple separated by ','
    Example: tag1,tag2
  • template_path string
    Theme template
    Example: templates/products/detail.json
  • title string
    Product title
    Example: This is a title
  • updated_at string
    Product update time
    Example: 2023-03-02T18:18:42.883+0800
  • variantsobject[]
    Style list
  • barcode string
    Bar code
    Example: B0000000001
  • compare_at_price string
    Original price
    Example: 1
  • id string
    Style id
    Example: 18058288104774469113432670
  • imageobject
    Style chart
  • alt string
    Picture alt
    Example: This is a image alt
  • src string
    Images src
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • inventory_policy string
    Allows oversold , continue or not : allowed , deny : not allowed
    Example: continue
  • inventory_quantity integer
    Suoyou summary of all locations
    Example: 1
  • inventory_tracker boolean
    Track inventory or not
    Example: true
  • option1 string
    Value for the first option that this style corresponds to
    Example: Red
  • option2 string
    Value for the second option that this style corresponds to
    Example: L
  • option3 string
    Value for the third option that this style corresponds to
  • option4 string
    Value of the fourth option that this style corresponds to
  • option5 string
    Value for the fifth option that this style corresponds to
  • price string
    Selling price
    Example: 1
  • product_id string
    Duiying id corresponding
    Example: 16058287356753569620272670
  • required_shipping boolean
    Shipping or not
  • sku string
    Sku
    Example: B0000001
  • taxable boolean
    Tax or not？
  • title string
    Style title
    Example: Red/L
  • weight string
    Weight
    Example: 1
  • weight_unit string
    Weight unit , g : g , kg : kg , lb : lb , oz : oz
    Example: g
  • vendor string
    Product manufacturer
    Example: Shopline
Status Codes
After receiving a webhook notification from SHOPLINE, you must respond with the following format:
HTTP/1.1 200 OK
For more information about how to subscribe to webhooks and webhook response rules, refer to Webhook overview.
Was this article helpful to you?
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.