Import Mappings (CSV)
POST/api/starshipit/integration-instances/:integration_instance/shipping-methods/import
Bulk-applies carrier/service-to-SKU-shipping-method mappings from an uploaded CSV (multipart/form-data, field file).
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Per row the target SKU shipping method is resolved by shipping_method_id first (authoritative), then by shipping_method_name (case-insensitive, matches the method name or full name). A row with both shipping-method columns blank removes the mapping for that code. The code is taken from the code column, or derived from carrier + carrier_service_code as "{carrier}|{carrier_service_code}".
Returns a summary of created / updated / deleted counts plus a list of human-readable per-line errors (e.g. unknown shipping method, missing code). Rows with errors are skipped; valid rows still apply.
Validation: file is required, must be a file of type csv or txt, max 2048 KB.
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.