Create Contractor
POST/api/manufacturing/contractors
Designate an existing supplier as a manufacturing contractor for outsourced production. Provisions a virtual warehouse that holds the stock issued to the contractor for its manufacturing orders. Auth: requires Bearer token. Body: supplier_id (required, integer, existing supplier id); virtual_warehouse_name (optional, string, max 255) - name for the contractor's virtual warehouse, a default is generated when omitted; default_outsourced_cost_basis (optional, string, one of: toll, hybrid) - default cost basis applied to new outsourced manufacturing orders for this contractor. Use toll when you own all component materials and the contractor only charges for processing (the contractor's product charge is treated as a processing cost, not added on top of your component costs). Use hybrid when the contractor supplies materials of their own beyond the components you provide (their charge is capitalized into the output cost). Omit or null to fall back to hybrid.
manufacturing:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Request
Responses
- 201
- 401
- 403
- 422
- 429
Created
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.
Unprocessable Entity
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.