Bulk Map Carrier/Services
PUT/api/starshipit/integration-instances/:integration_instance/shipping-methods/bulk-map
Maps many carrier/service codes to a single SKU shipping method in one call (used by the bulk-select "Apply to selected" action on the mappings page). Codes are de-duplicated and blank entries skipped.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Request body:
codes(array of string, required, min 1; each max 255) — the carrier/service codes to map, format"{carrier}|{carrier_service_code}"shipping_method_id(integer, required) — must exist inshipping_methods
Returns the number of mappings written.
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.