Deliverr API Guide - Products

You will require the api/productsscope for this guide.

1. Set up Products (if you are using existing Deliverr products for order fulfillment)

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

     curl --location --request PATCH '<https://api.deliverr.com/products/v1/product/{productId}/link/{externalProductId}>' \\
     --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
     
     

2. Set up Products (if you are creating new products for order fulfillment)

   • Create products that can later be used in your shipping plans for inbounds and creating orders. You can create products through the Create Product endpoint

     curl --location --request POST '<https://api.deliverr.com/products/v1/product>' \\
     --header 'Authorization: Bearer {valid_access_token}' \\
     --header 'Content-Type: application/json' \\
     --data-raw '{
         "externalProductId": "{seller_product_id}",
         "sku": "{seller_sku}",
         "title": "{seller_title}",
     		"category": "OTHER"
     }'
     

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

3. Confirm that the product is set up correctly

   • Once you have created and/or linked your products, you can verify that they have been connected properly by running the Get product by externalProductId endpoint and see if you get the expected product back

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

     Use the externalProductId you linked previously to validate.

4. Confirm Product Inventory

   • Once you have created products and successfully inbounded inventory for those products, you can confirm that you have inventory for those endpoints by using the Get Product Inventory endpoint.

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

     You can confirm inventory by making sure that the availableUnits field in the response is greater than 0.