Create SKU

Requires write_products access scope.
For more info , refer to:
POST https://{handle}.myshopline.com/admin/openapi/v20250601/products/:product_id/variants.json
handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .
Create SKU
Path Parameters
  • product_id string required
    Product ID
Request Headers
  • Content-Type required
    The value of this field is fixed to application/json; charset=utf-8
  • Authorization string required
    The access token for the API. Please refer to App authorization to obtain the access token, and then put the obtained access token into the API request header in Bearer Token.
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
Request Body
  • variantobject
    Variant information
  • barcode string
    Barcode , limited to 255 characters
    Example: T0000001
  • compare_at_price string
    Original price
    Example: 99
  • imageobject
    Images
  • alt string
    Alt information of the image , limited to 512 characters
    Example: This is a image alt
  • id string
    Image id , note : must be the image in the main image
    Example: 5759070976424132652
  • src string
    Corresponding image src link, limited to 255 characters
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • inventory_policy string
    Oversold strategy , continue : allowed , deny : not allowed
    Example: deny
  • inventory_tracker boolean
    Track inventory , default is not tracking or not
    Example: true
  • option1 string
    The variant corresponds to the value of the option1 limited to 255 characters
    Example: Red
  • option2 string
    The variant corresponds to the value of the option2 limited to 255 characters
    Example: L
  • option3 string
    The variant corresponds to the value of the option3 limited to 255 characters
  • option4 string
    The variant corresponds to the value of the option4 limited to 255 characters
  • option5 string
    The variant corresponds to the value of the option5 limited to 255 characters
  • price string
    Selling price
    Example: 90
  • required_shipping boolean
    Shipping or not
    Example: true
  • sku string
    SKU code , the length cannot exceed 255
    Example: S0000001
  • taxable boolean
    Tax collection or not required
    Example: true
  • weight string
    Weight
    Example: 0.2
  • weight_unit string
    Weight units : g , kg , lb , oz , zh_kg
    Example: kg
Response
For more information about status codes, see Http status code.
Response Headers
  • traceId
    traceId
Response Body
  • variantobject
    Variant information
  • barcode string
    Barcode
    Example: T000000001
  • compare_at_price string
    Original price
    Example: 99
  • created_at string
    Creation time
    Example: 2021-09-02T14:11:54+00:00
  • id string
    id
    Example: 18057039439794751459380282
  • imageobject
    Images
  • alt string
    Image alt
    Example: This is a image alt
  • id string
    Image id
    Example: 5785060242207917075
  • src string
    Image src
    Example: https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png
  • inventory_item_id string
    Inventory item id
    Example: 5985060242375689228
  • inventory_policy string
    Oversold strategy: deny - Oversold is not allowed, continue - Oversold is allowed
    Example: deny
  • inventory_quantity integer
    All locations summary of inventory
  • inventory_tracker boolean
    Track inventory or not
    Example: true
  • option1 string
    The variant corresponds to the value of the option1
    Example: Red
  • option2 string
    The variant corresponds to the value of the option2
    Example: L
  • option3 string
    The variant corresponds to the value of the option3
  • option4 string
    The variant corresponds to the value of the option4
  • option5 string
    The variant corresponds to the value of the option5
  • price string
    Selling price
    Example: 90
  • product_id string
    Product ID
    Example: 16057039432335097907370282
  • required_shipping boolean
    Shipping or not
    Example: true
  • sku string
    SKU code
    Example: S00000001
  • taxable boolean
    Tax collection or not required
    Example: true
  • updated_at string
    Update time
    Example: 2021-09-02T14:11:54+00:00
  • weight string
    Weight
    Example: 0.2
  • weight_unit string
    Weight units : g , kg , lb , oz , zh_kg
    Example: kg
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

— path required
— header required

Body

required
{
  "variant": {
    "barcode": "T0000001",
    "compare_at_price": "99",
    "image": {
      "alt": "This is a image alt",
      "id": "5759070976424132652",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "inventory_policy": "deny",
    "inventory_tracker": true,
    "option1": "Red",
    "option2": "L",
    "option3": "",
    "option4": "",
    "option5": "",
    "price": "90",
    "required_shipping": true,
    "sku": "S0000001",
    "taxable": true,
    "weight": "0.2",
    "weight_unit": "kg"
  }
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/products/product_id/variants.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
Add variant
Request
{
  "variant": {
    "barcode": "T0000001",
    "compare_at_price": "99",
    "image": {
      "alt": "This is a image alt",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "inventory_policy": "continue",
    "inventory_tracker": "true",
    "option1": "S",
    "option2": "White",
    "price": "90",
    "required_shipping": "true",
    "sku": "S0000001",
    "taxable": "true",
    "weight": "0.5",
    "weight_unit": "kg"
  }
}
Response
{
  "variant": {
    "barcode": "T0000001",
    "compare_at_price": "99.00",
    "created_at": "2023-08-29T15:32:54+08:00",
    "id": "18060895634402500988513144",
    "image": {
      "alt": "This is a image alt",
      "id": "6089563432963689533",
      "src": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png"
    },
    "inventory_item_id": "6089563439612587791",
    "inventory_policy": "continue",
    "inventory_tracker": true,
    "option1": "S",
    "option2": "White",
    "price": "90.00",
    "product_id": "16060895302856191591063144",
    "required_shipping": true,
    "sku": "S0000001",
    "taxable": true,
    "updated_at": "2023-08-29T15:32:54+08:00",
    "weight": "0.50",
    "weight_unit": "kg"
  }
}
Was this article helpful to you?
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.