Create Product

POST

/2026-01/product

POST

/2026-01/product

1 using RestSharp;
2 
3 var client = new RestClient("https://api.shipbob.com/2026-01/product");
4 var request = new RestRequest(Method.POST);
5 request.AddHeader("Authorization", "Bearer <token>");
6 request.AddHeader("Content-Type", "application/json");
7 request.AddParameter("application/json", "{\n  \"is_quarantine\": true,\n  \"name\": \"string\",\n  \"taxonomy_id\": 0,\n  \"type_id\": 1,\n  \"variants\": [\n    {\n      \"additional_hazmat_attributes\": {\n        \"charge_state_percentage\": 0.1,\n        \"container_type\": \"string\",\n        \"lithium_battery_packaging\": \"string\",\n        \"lithium_battery_type\": \"string\",\n        \"magnet\": true,\n        \"net_volume\": 0.1,\n        \"net_weight\": 0.1,\n        \"container_metal\": true\n      },\n      \"barcodes\": [\n        {\n          \"sticker_url\": \"string\",\n          \"value\": \"string\"\n        }\n      ],\n      \"bundle_definition\": [\n        {\n          \"quantity\": 0,\n          \"variant_id\": 0\n        }\n      ],\n      \"channel_metadata\": [\n        {\n          \"channel_id\": 0,\n          \"currency\": \"string\",\n          \"id\": 0,\n          \"is_inventory_sync_enabled\": true,\n          \"legacy_product_id\": 0,\n          \"platform\": \"string\",\n          \"platform_identifier\": \"string\",\n          \"platform_inventory_item_id\": \"string\",\n          \"price\": 0.1,\n          \"seller_sku\": \"string\"\n        }\n      ],\n      \"customs\": {\n        \"country_code_of_origin\": \"string\",\n        \"description\": \"string\",\n        \"hs_tariff_code\": \"string\",\n        \"is321_eligible\": true,\n        \"value\": 0\n      },\n      \"dimension\": {\n        \"height\": 0.1,\n        \"length\": 0.1,\n        \"width\": 0.1\n      },\n      \"fulfillment_settings\": {\n        \"dangerous_goods\": true,\n        \"is_bpm_parcel\": true,\n        \"is_case_pick\": true,\n        \"msds_url\": \"string\",\n        \"requires_prop65\": true,\n        \"serial_scan\": {\n          \"exact_character_length\": 0,\n          \"is_enabled\": true,\n          \"prefix\": \"string\",\n          \"suffix\": \"string\"\n        }\n      },\n      \"gtin\": \"string\",\n      \"is_digital\": true,\n      \"lot_information\": {\n        \"is_lot\": true,\n        \"minimum_shelf_life_days\": 0\n      },\n      \"name\": \"string\",\n      \"packaging_material_type_id\": 0,\n      \"packaging_requirement_id\": 0,\n      \"return_preferences\": {\n        \"backup_action_id\": 0,\n        \"instructions\": \"string\",\n        \"primary_action_id\": 0,\n        \"return_to_sender_backup_action_id\": 0,\n        \"return_to_sender_primary_action_id\": 0\n      },\n      \"sku\": \"string\",\n      \"status_id\": 0,\n      \"upc\": \"string\",\n      \"weight\": 0.1\n    }\n  ]\n}", ParameterType.RequestBody);
8 IRestResponse response = client.Execute(request);

201Products_createProduct_example

1 {
2   "created_on": "2019-08-24T14:15:22Z",
3   "id": 0,
4   "name": "string",
5   "taxonomy": {
6     "id": 0,
7     "name": "string",
8     "parent_id": 0,
9     "parent_name": "string",
10     "path": "string"
11   },
12   "type": "string",
13   "updated_on": "2019-08-24T14:15:22Z",
14   "user_id": 0,
15   "variants": [
16     {
17       "barcodes": [
18         {
19           "sticker_url": "string",
20           "value": "string"
21         }
22       ],
23       "channel_metadata": [
24         {
25           "channel_id": 0,
26           "channel_name": "string",
27           "currency": "string",
28           "id": 0,
29           "is_inventory_sync_enabled": true,
30           "legacy_product_id": 0,
31           "platform": "string",
32           "platform_identifier": "string",
33           "platform_inventory_item_id": "string",
34           "price": 0.1,
35           "seller_sku": "string"
36         }
37       ],
38       "additional_hazmat_attributes": {
39         "charge_state_percentage": 0.1,
40         "container_metal": true,
41         "container_type": "string",
42         "lithium_battery_packaging": "string",
43         "lithium_battery_type": "string",
44         "magnet": true,
45         "net_volume": 0.1,
46         "net_weight": 0.1
47       },
48       "associated_bundles": [
49         {
50           "product_id": 0,
51           "product_name": "string",
52           "quantity": 0,
53           "variant_id": 0,
54           "variant_sku": "string"
55         }
56       ],
57       "bundle_definition": [
58         {
59           "product_id": 0,
60           "quantity": 0,
61           "variant_id": 0,
62           "variant_name": "string",
63           "variant_sku": "string"
64         }
65       ],
66       "created_on": "2019-08-24T14:15:22Z",
67       "customs": {
68         "country_code_of_origin": "string",
69         "currency": "string",
70         "description": "string",
71         "hs_tariff_code": "string",
72         "is321_eligible": true,
73         "value": 0
74       },
75       "dimension": {
76         "height": 0.1,
77         "is_locked": true,
78         "length": 0.1,
79         "source": "string",
80         "unit": "string",
81         "width": 0.1
82       },
83       "fulfillment_settings": {
84         "dangerous_goods": true,
85         "is_bpm_parcel": true,
86         "is_case_pick": true,
87         "msds_url": "string",
88         "requires_prop65": true,
89         "serial_scan": {
90           "exact_character_length": 0,
91           "is_enabled": true,
92           "prefix": "string",
93           "suffix": "string"
94         }
95       },
96       "gtin": "string",
97       "id": 0,
98       "inventory": {
99         "inventory_id": 0,
100         "on_hand_qty": 0
101       },
102       "is_digital": true,
103       "is_image_uploaded": true,
104       "lot_information": {
105         "is_lot": true,
106         "minimum_shelf_life_days": 0
107       },
108       "merge_children": [
109         {
110           "channel_ids": [
111             0
112           ],
113           "completed_at": "2019-08-24T14:15:22Z",
114           "inventory_id": 0,
115           "variant_id": 0,
116           "variant_name": "string"
117         }
118       ],
119       "name": "string",
120       "packaging_material_type": {
121         "id": 0,
122         "name": "string"
123       },
124       "packaging_requirement": {
125         "id": 0,
126         "name": "string"
127       },
128       "return_preferences": {
129         "backup_action": {
130           "id": 0,
131           "name": "string"
132         },
133         "instructions": "string",
134         "primary_action": {
135           "id": 0,
136           "name": "string"
137         },
138         "return_to_sender_backup_action": {
139           "id": 0,
140           "name": "string"
141         },
142         "return_to_sender_primary_action": {
143           "id": 0,
144           "name": "string"
145         }
146       },
147       "reviews_pending": [
148         "string"
149       ],
150       "sku": "string",
151       "status": "string",
152       "upc": "string",
153       "updated_on": "2019-08-24T14:15:22Z",
154       "weight": {
155         "unit": "string",
156         "weight": 0.1
157       }
158     }
159   ]
160 }

Creates a new product with one or more variants. Requires a product name and at least one variant with a unique SKU.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token or OAuth2

Request

The product to add

is_quarantinebooleanOptional

Flag indicating whether the product should be created in quarantine status

namestring or nullOptional

The name of the product

taxonomy_idinteger or nullOptional

The taxonomy ID for categorizing the product

type_idenumOptional

The product type ID (1 = Regular, 2 = Bundle)

Allowed values:

variantslist of objects or nullOptional

List of variants to create with the product. At least one variant is required. Each variant must have a unique SKU.

Response

Created

created_ondatetime or null

Timestamp when the product was created

idlong or null

Unique identifier for the product

namestring or null

Product name

taxonomyobject or null

Product categorization information including category hierarchy

typestring or null

Product type (e.g., ‘Regular’ or ‘Bundle’)

updated_ondatetime or null

Timestamp when the product was last updated

user_idlong or null

ID of the user who owns this product

variantslist of objects or null

List of variants belonging to this product. Each variant represents a specific SKU.