Bulk Map Shipping Methods
POST/api/shiprush/instances/:integration_instance/shipping-methods/bulk-map
Bulk-map a set of rows to one SKU shipping method, and/or auto-match every still-unmapped row by normalized name. Two paths share the endpoint and may be combined in one call.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Body fields (all optional):
- ids (array of integers): the mapping row ids to map. When present, each is set to shipping_method_id.
- shipping_method_id (integer, nullable): the SKU shipping method to map the ids to. Must reference an existing shipping method; a null value clears the mapping on those rows.
- auto_match (boolean): when true, runs a name-match sweep over every still-unmapped row and maps the ones it can resolve.
Returns the affected counts: mapped (rows set via ids), matched / unmatched (rows the auto-match sweep resolved / could not resolve). Returns 422 when shipping_method_id does not reference an existing shipping method.
Authentication: Requires a 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 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.