Create a Product with Attributes


When to Use

  • If you need to create a product in the system that doesn't already exist with the Sku value you will send AND will add/create the attributes passed in the call at the same time.

    • This is helpful because if attributes are not added during product creation, then individual calls to create attributes will be required and will count toward call limit totals.
  • To create any other product type (Bundle, Child, Parent) with attributes, you simply need to add the Attributes collection and properly formatted Name/Values combination for each attribute to be added.

Resource URL / Endpoint

POST https://api.channeladvisor.com/v1/Products

 Important and/or Required Parameters

Property Type (Max Length) Required Note
ProfileID integer (32 bit) Conditional Include in body. Identifies the ChannelAdvisor profile - required if authorization spans multiple profiles.
Sku string (50) Required Include in body. Unique identifier of the product within the seller's catalog.
Title string (120) Required Include in body. Trim if > 120 characters for this property and plan to add the full value as an attribute.
Attributes [ Name ] string (32) Required Include in body. Name of the attribute being created or applied.
Attributes [ Value ] string (32,000) Required Include in body. Value to be applied to the corresponding named attribute.
All other Product Entity fields are optional to create a product. Those provided below are for example purposes only.
Example Request
POST https://api.channeladvisor.com/v1/Products?access_token=xxxxxxxxxx
{
	"ProfileID": "12345678",
	"Sku": "10000002",
	"Title": "WingLights Fixed - Direction Indicators for Bicycles/Turning Signals/Blinkers",
	"Brand": "WingLights",
	"Manufacturer":"Bike Products Inc.",
	"MPN": "wlf-di-bikes",
	"Condition":"New",
	"Description":"WingLights is not only a direction indicators for bicyles, it is the first of its kind. Produced by a multi-awarded startup, WingLights represents an important improvement for cycling safety accessories. It provides the same visual signal as cars and motocycles do when they are about to turn.<p>Indeed, the tempo and luminosity are the exactly the same as the ones required for cars and motocycles by legislation. You can now exercise or commute safely everywhere, anytime, even in an urban environment.<p>Who said innovation had to be complex?",
	"UPC": "012345678901",
	"BuyItNowPrice": 34.99,
	"RetailPrice": 39.99,
	"Attributes":[{
	   "Name":"Size",
	   "Value":"XL"
	   },{
	   "Name":"Color",
	   "Value":"Black"
	   },{
	   "Name":"Material",
	   "Value":"Stainless Steel"
	   }
	]
}
Example Response (Success)
201 CREATED
{
  "@odata.context": "https://api.channeladvisor.com/v1/$metadata#Products/$entity",
  "ID": 24363235,
  "ProfileID": 12345678,
  "Brand": "WingLights",
  "Condition": "NEW",
  "Description": "WingLights is not only a direction indicators for bicyles, it is the first of its kind. Produced by a multi-awarded startup, WingLights represents an important improvement for cycling safety accessories. It provides the same visual signal as cars and motocycles do when they are about to turn.<p>Indeed, the tempo and luminosity are the exactly the same as the ones required for cars and motocycles by legislation. You can now exercise or commute safely everywhere, anytime, even in an urban environment.<p>Who said innovation had to be complex?",
  "Manufacturer": "Bike Products Inc.",
  "MPN": "wlf-di-bikes",
  "Sku": "10000002",
  "TaxProductCode": null,
  "Title": "WingLights Fixed - Direction Indicators for Bicycles/Turning Signals/Blinkers",
  "UPC": "012345678901",
  "RetailPrice": 39.99,
  "BuyItNowPrice": 34.99,
  "StorePrice": null,
  "IsParent": false,
  "IsInRelationship": false,
  "ParentProductID": null,
  "RelationshipName": null
  // Additional fields omitted
}