Documentation

Trendyol guide

Product V2 only. V1 closes 15 September 2026.

Warning: Trendyol Product V1 closes on 15 September 2026. Integration uses Product V2 only. No V1 URLs.

Auth

REST, HTTP Basic (apiKey:apiSecret) + sellerId. Stage + IP allowlist (ops checklist).

Catalog

  • Join key: barcode
  • Product create is async; poll getBatchRequestResult with batchRequestId (~4 hours)
  • Category: leaf categoryId + required attributeValueIds
  • Brands: getBrands / createBrand

Price and inventory

POST .../products/price-and-inventory

  • Max 1000 SKUs
  • Same request must not repeat within 15 minutes
  • Per-product stock cap 20,000
  • Validate listPrice >= salePrice

Orders

Unit is the shipment package. Seller: Created → Picking → Invoiced. Cargo: Shipped → Delivered.

Webhook: POST /api/2026-07/channels/:channel/hooks/:accountId — HTTP 200 within 3s, BASIC or x-api-key. Webhooks are not enough; a 5 minute getShipmentPackages pull is mandatory.

Labels: createCommonLabel / getCommonLabel (ZPL). Invoices: sendInvoiceLink only.

This page is a guide. apps/www does not call the live Trendyol API.