Add a single product to the store | ShipBob Developer API

curl -X POST https://api.shipbob.com/1.0/product \
     -H "shipbob_channel_id: shipbob_channel_id" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Medium Blue T-Shirt",
  "reference_id": "TShirtBlueM",
  "barcode": "123456789012",
  "gtin": "012345678905",
  "sku": "TShirtBlueM",
  "unit_price": 20.32,
  "upc": "012345678912"
}'

{
  "barcode": "123456789012",
  "bundle_root_information": {
    "id": 0,
    "name": "string"
  },
  "channel": {
    "id": 0,
    "name": "House of Slippers"
  },
  "created_date": "2019-08-24T14:15:22Z",
  "fulfillable_inventory_items": [
    {
      "id": 0,
      "name": "Medium Blue T-Shirt",
      "quantity": 0
    }
  ],
  "fulfillable_quantity_by_fulfillment_center": [
    {
      "committed_quantity": 0,
      "fulfillable_quantity": 0,
      "id": 0,
      "name": "Cicero",
      "onhand_quantity": 0
    }
  ],
  "gtin": "012345678905",
  "id": 0,
  "name": "Medium Blue T-Shirt",
  "reference_id": "TShirtBlueM",
  "sku": "TShirtBlueM",
  "total_committed_quantity": 0,
  "total_fulfillable_quantity": 0,
  "total_onhand_quantity": 0,
  "unit_price": 20.32,
  "upc": "012345678912"
}

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Request

The product to add

namestringRequired1-2000 characters

The name of the product

reference_idstringRequired1-400 characters

Unique reference identifier for the product. Any linked or generated inventory will also be uniquely identified by this value

barcodestring or nullOptional<=150 characters

Barcode for the product

gtinstring or nullOptional<=50 characters

Global Trade Item Number - unique and internationally recognized identifier assigned to item by company GS1.

skustring or nullOptional<=400 characters

Stock keeping unit for the product

unit_pricedouble or nullOptional

The price of one unit

upcstring or nullOptional<=50 characters

Universal Product Code - Unique external identifier

Response

Success

barcodestring or nullOptional

Barcode for the product

bundle_root_informationobjectOptional

channelobjectOptional

Information about a store channel

created_datedatetimeOptional

Date the product was created

fulfillable_inventory_itemslist of objects or nullOptional

The inventory that this product will resolve to when packing a shipment

fulfillable_quantity_by_fulfillment_centerlist of objects or nullOptional

Fulfillable quantity of this product broken down by fulfillment center location

gtinstring or nullOptional

Global Trade Item Number - unique and internationally recognized identifier assigned to item by company GS1.

idintegerOptional

Unique identifier of the product

namestring or nullOptional

The name of the product

reference_idstring or nullOptional

Unique reference identifier of the product

skustring or nullOptional

Stock keeping unit for the product

total_committed_quantityintegerOptional

Total committed quantity of this product

total_fulfillable_quantityintegerOptional

Total fulfillable quantity of this product

total_onhand_quantityintegerOptional

Total on hand quantity of this product

unit_pricedouble or nullOptional

The price of one unit

upcstring or nullOptional

Universal Product Code - Unique external identifier

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

Authentication

Headers

Request

Response

Errors