DEdepop

`v1:order.new` New order webhook

This webhook is sent whenever a new order is placed on Depop. The webhook will contain the details of the order, including the buyer's address and the items purchased. You can use this webhook to update your inventory and other platforms that the item is no longer available. Please make sure you're using the orders endpoint to reconcile the orders you have received via webhooks, as these will have a best effort delivery.

postWebhooknewOrder

Payload

idstring required

The identifier of the webhook. For the order webhooks (v1:order.new, v1:order.refund, v1:order.update) this is derived from the purchase ID, so it is stable per order and shared across those event types rather than unique per delivery. Combine it with event_type and created_at if you need to de-duplicate.

event_type'v1:order.new' | 'v1:order.refund' | 'v1:order.update' | 'v1:product.create' | 'v1:product.like' | 'v1:product.unlike' | 'v1:product.update' required

The type of event that triggered the webhook.

created_atstring date-time required

The date and time the webhook was created.

Example payload

{
  "id": "a210923f-c1f3-4d84-a2bd-7f18c68553e2",
  "event_type": "v1:order.new",
  "created_at": "2025-01-01T00:00:00Z",
  "data": {
    "seller_id": 123456,
    "purchase_id": "123456",
    "status": "SHIPPING_PENDING",
    "currency": "GBP",
    "buyer_pays_amount": "50.99",
    "seller_receives_amount": "45.99",
    "fee_amount": "5.00",
    "buyer_shipping_price": "5.00",
    "buyer_address": {
      "name": "John Doe",
      "address": "123 Main St",
      "address2": "Apt 1",
      "city": "London",
      "postal_code": "EC1V 4PW",
      "state": "Greater London",
      "country": "GB",
      "phone_number": "07123456789"
    },
    "line_items": [
      {
        "purchase_item_id": 2385551,
        "sku": "ABC-12345-S-BL",
        "product_id": 7021251,
        "slug": "vintage-nike-t-shirt-7021251",
        "parcel_id": "6e3538ca-6653-3c25-bf0a-a2be876b17e4",
        "description": "Vintage Nike T-Shirt in excellent condition",
        "original_price": "29.99",
        "sold_price": "25.99",
        "sold_via_offers": false,
        "image_url": "https://media-photos-staging.depop.com/b0/18220/5612584_b6795bc34778465293e45647518906d6/P0.jpg"
      }
    ],
    "depop_shipping": {
      "shipping_provider_id": "USPS"
    }
  }
}

Response

Acknowledgment

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.