Skip to content

Managing Shipping

Our API supports two shipping methods:

  • Manual Shipping. Sellers manage their own shipping logistics and set a flat national shipping cost.
  • Depop Managed Shipping. Depop handles shipping logistics and automatically calculates costs based on the selected provider and parcel size.

Info

Important: When creating or updating a product, you must provide either national_shipping_cost or depop_shipping, but not both.

If no shipping providers are available for your address, you'll need to use manual shipping instead.

Manual Shipping

With manual shipping, sellers control all aspects of the shipping process. They set a flat national_shipping_cost for their products, and are responsible for:

  • Choosing their own shipping carrier
  • Printing shipping labels
  • Providing tracking information to Depop once shipped

When creating or updating a product with manual shipping, provide the national_shipping_cost field:

{
  "price_amount": "50.00",
  "national_shipping_cost": "3.50",
  ...
}

Set national_shipping_cost to "0.00" for free shipping (the seller covers the cost).

After fulfilling the order, use the /api/v1/orders/{purchase_id}/parcels/{parcel_id}/mark-as-shipped/ endpoint to provide the tracking code to Depop. This updates the order status and notifies the buyer. You can find out more about processing an order in this how to guide: Processing Orders.

Depop Managed Shipping

With Depop managed shipping, Depop takes care of the shipping logistics and automatically calculates the shipping cost based on the selected provider and parcel size. This option is ideal if you want to:

  • Easily print shipping labels directly from Depop
  • Reduce manual work by letting Depop handle carrier integration
  • Provide buyers with accurate shipping costs and tracking information

Setting up Depop Managed Shipping

To use Depop managed shipping, follow these steps:

1. Retrieve your seller addresses

Use the /api/v1/shop/seller-addresses/ endpoint to get all addresses associated with the seller's shop. Each address has an address_id that you'll need in the next steps.

2. Get available shipping providers

For the selected address, retrieve the available shipping providers using the /api/v1/shop/seller-addresses/{address_id}/shipping-providers/ endpoint. This returns providers and their available parcel sizes with pricing information.

Note

Common providers include USPS (US), MY_HERMES/EVRI (UK), and SENDLE (Australia).

Parcel sizes typically include options like SMALL, MEDIUM, and LARGE.

3. Construct the request with provider and parcel size id's

Choose the appropriate shipping provider and parcel size for the product based on the response from step 2.

When creating or updating a product, include the depop_shipping object in your request body:

{
  "price_amount": "50.00",
  "depop_shipping": {
    "address_id": 123456,
    "shipping_provider_id": "USPS",
    "parcel_size_id": "SMALL",
    "payer": "buyer"
  },
  ...
}