Skip to main content

Import Shiptheory Delivery Service Mappings CSV

POST 

/api/shiptheory/:integration_instance/delivery-services/import-csv

Applies a CSV of mapping rows. Rows are keyed by Shiptheory's own service_id; the SKU method resolves by sku_shipping_method_id (authoritative) or sku_shipping_method_name (fallback); both blank clears the mapping back to the rules engine. The response summarizes rows created, updated, removed, and any per-line errors.

Required scope: integrations:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Content-Type: multipart/form-data.

Path parameter:

  • integration_instance: the numeric id of the Shiptheory integration instance.

Form field:

  • file (file, required): a CSV file (.csv or .txt), max 2 MB.

Returns 200 with the import summary. Returns 422 with field errors when the upload is missing or not a CSV.

Authentication: requires a Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type