Adds new product variants to a product

POST

/2025-07/product/:productId/variants

POST

/2025-07/product/:productId/variants

1 curl -X POST https://api.shipbob.com/2025-07/product/productId/variants \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '[
5   {
6     "additional_hazmat_attributes": {
7       "charge_state_percentage": 0.1,
8       "container_type": "string",
9       "lithium_battery_packaging": "string",
10       "lithium_battery_type": "string",
11       "magnet": true,
12       "net_volume": 0.1,
13       "net_weight": 0.1,
14       "container_metal": true
15     },
16     "barcodes": [
17       {
18         "sticker_url": "string",
19         "value": "string"
20       }
21     ],
22     "bundle_definition": [
23       {
24         "quantity": 0,
25         "variant_id": 0
26       }
27     ],
28     "channel_metadata": [
29       {
30         "asin": "string",
31         "fnsku": "string",
32         "fulfillment_channel": "string",
33         "channel_id": 0,
34         "currency": "string",
35         "id": 0,
36         "is_inventory_sync_enabled": true,
37         "legacy_product_id": 0,
38         "platform": "string",
39         "platform_identifier": "string",
40         "platform_inventory_item_id": "string",
41         "price": 0.1,
42         "seller_sku": "string"
43       }
44     ],
45     "customs": {
46       "country_code_of_origin": "string",
47       "description": "string",
48       "hs_tariff_code": "string",
49       "is321_eligible": true,
50       "value": 0
51     },
52     "dimension": {
53       "height": 0.1,
54       "length": 0.1,
55       "width": 0.1
56     },
57     "fulfillment_settings": {
58       "dangerous_goods": true,
59       "is_bpm_parcel": true,
60       "is_case_pick": true,
61       "msds_url": "string",
62       "requires_prop65": true,
63       "serial_scan": {
64         "exact_character_length": 0,
65         "is_enabled": true,
66         "prefix": "string",
67         "suffix": "string"
68       }
69     },
70     "gtin": "string",
71     "is_digital": true,
72     "lot_information": {
73       "is_lot": true,
74       "minimum_shelf_life_days": 0
75     },
76     "name": "string",
77     "packaging_material_type_id": 0,
78     "packaging_requirement_id": 0,
79     "return_preferences": {
80       "backup_action_id": 0,
81       "instructions": "string",
82       "primary_action_id": 0,
83       "return_to_sender_backup_action_id": 0,
84       "return_to_sender_primary_action_id": 0
85     },
86     "sku": "string",
87     "status_id": 0,
88     "upc": "string",
89     "weight": 0.1
90   }
91 ]'

201Products_addsNewProductVariantsToAProduct_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 }

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Path parameters

productIdstringRequiredformat: "int64"

Request

The product variants to add to product

additional_hazmat_attributesobjectOptional

barcodeslist of objects or nullOptional

bundle_definitionlist of objects or nullOptional

channel_metadatalist of objects or nullOptional

customsobjectOptional

dimensionobjectOptional

fulfillment_settingsobjectOptional

gtinstring or nullOptional

is_digitalbooleanOptional

lot_informationobjectOptional

namestring or nullOptional

packaging_material_type_idinteger or nullOptional

packaging_requirement_idinteger or nullOptional

return_preferencesobjectOptional

skustring or nullOptional

status_idintegerOptional

upcstring or nullOptional

weightdoubleOptional

Response

Created

created_ondatetime or null

idlong or null

namestring or null

taxonomyobject or null

typestring or null

updated_ondatetime or null

user_idlong or null

variantslist of objects or null