Mark shipped / attach tracking
POST /rest/v1/orders/{id}/fulfillment
Marks the order as shipped and/or attaches tracking. Applies to the WHOLE channel order this line belongs to. With tracking present, Nembol also notifies the source marketplace (default; disable with notify_channel: false) — supported on eBay, Etsy, Shopify, WooCommerce, Amazon, TikTok Shop, OnBuy, Square and Squarespace. Marketplace notification is once-per-order (hard idempotent). Requires the orders:write scope.
Authorization
apiKey Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Path Parameters
Header Parameters
Unique client-generated key (max 255 chars), stored 24h.
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/orders/string/fulfillment" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "ord_1f83b", "object": "order", "channel_account_id": "string", "channel": "string", "order_id_on_channel": "string", "order_url": "http://example.com", "status": "awaiting_payment", "fulfillment_status": "unfulfilled", "source_status": "string", "tracking": { "number": "string", "carrier": "string", "url": "http://example.com" }, "currency": "string", "total": "19.90", "lines": [ { "sku": "string", "title": "string", "quantity": 0, "price": "19.90", "product_id": "string" } ], "buyer": { "name": "string", "email": "string", "country": "string", "address": { "line1": "string", "line2": "string", "city": "string", "zip": "string", "province": "string", "country": "string" } }, "created_at": "2019-08-24T14:15:22Z"}Last updated on July 30, 2026
Need help?
The API is in private beta — email us and a human replies, usually within one business day.