Deliverr API Guide - Bundles

Once you have created the products you want to ship, you can create bundles with those products as well. You can create virtual bundles using the Create Bundle endpoint

curl --location --request POST '<https://api.deliverr.com/bundles/v1/bundle>' \\
--header 'Content-Type: application/json' \\
--header 'Accept: application/json' \\
--header 'Authorization: Bearer {valid_access_token}' \\
--data-raw '{
	"externalBundleId": "string",
	"title": "string",
	"sku": "string",
	"bundleContents": [
		{
			"productId": "string",
			"quantity": 0
		}
	]
}'

The response has a bundleId field which corresponds with the BSKU value in Seller Portal. You can see the products you create on Seller Portal at *https://sellerportal.deliverr.com/inventory/bundles/{bundleId}*

If you want to connect an externalBundleId to an existing Deliverr bundle, make a request to the Link externalBundleId endpoint to link an externalBundleId you can define to the existing Deliverr product

curl --location --request PATCH '<https://api.deliverr.com/bundles/v1/bundle/{bundleId}/link/{externalBundleId}>' \\
--header 'Authorization: Bearer {valid_access_token}' 

In this request, the productId should be the DSKU value of the existing product, and the externalProductId is defined by you

Once you have created and/or linked your bundles, you can confirm that they have been set up correctly by using the Get Bundle by externalBundleId endpoint and confirming that you receive the bundle you were expecting.

curl --location --request GET '<https://api.deliverr.com/products/v1/product/{productId}/inventory>' \\
--header 'Authorization: Bearer {valid_access_token}'

You can confirm that a bundle is ready to receive orders and be shipped by running the Get Bundle Inventory endpoint and making sure the availableUnits is more than 0.

curl --location --request GET '<https://api.deliverr.com/bundles/v1/bundle/{bundleId}/inventory>' \\
--header 'Authorization: Bearer {valid_access_token}'

NOTE: To use a bundle when creating an order, use the externalBundleId in the order line item's externalProductId field.