Skip to main content

Bulk Sync Fulfillment Orders from Provider

POST 
/api/fulfillment-orders/bulk-sync-from-provider

Update tracking for many fulfillment orders at once by polling each one's registered provider order. Accepts an explicit ids selection, or apply_to_all=true — in which case the entire filtered set is resolved server-side from the request query string's current filter[...] / filter_groups parameters (the same filters as the fulfillment orders list endpoint). There is no body filters parameter.

Required scope: orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

This endpoint is asynchronous: it dispatches a background job and returns immediately with a tracked_job_log_id that can be used to monitor progress. Fulfillment orders with no registered provider order yet are skipped by the job rather than rejected here.

Body fields:

  • ids (array of integers, required unless apply_to_all is true) — fulfillment order IDs to sync.
  • apply_to_all (optional, boolean) — sync every fulfillment order matching the current query-string filters.

Authentication: Requires Bearer token.

Required permission: fulfillment_orders.submit (Fulfillment Orders → Submit & sync) and fulfillment_orders.index (Fulfillment Orders → View). A token also needs its orders scope; the owner needs these role permissions.

Request​

Responses​

OK

Response Headers
    Content-Type