Sync Costs to Shopify
POST/api/shopify/:integrationInstance/costs/sync
Push each mapped listing's average cost to the Shopify variant's "Cost per item" field. Runs asynchronously; poll Get Cost Sync Progress with the returned tracked_job_log_id.
Costs are pushed in the store's currency (converted from your base currency using your configured exchange rate). Products with no average cost are skipped, never zeroed. Bundles push the sum of component costs; a bundle is skipped when any component has no cost. Values already matching Shopify are skipped.
Requires the "Push costs" sync capability to be enabled for the integration instance.
Authentication: Requires Bearer token.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.