Update shipping cost settings

Switch the shipping cost attribution method. fixedRateAmount is required when method=fixed_rate.

Triggers a per-order COGS recalculation downstream.

Required scope: costs:write.

PUT /accounts/api/costs/shipping-settings

cURL

fixedRate

curl --request PUT \
  --url https://api.upstackdata.com/accounts/api/costs/shipping-settings \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-pixel-id: <api-key>' \
  --data '
{
  "method": "fixed_rate",
  "fixedRateAmount": 7.5,
  "currency": "USD"
}
'

200

{
  "config": {}
}

Authorizations

x-api-key · string · header · required

Your Upstack API key. Starts with upstack_.

x-pixel-id · string · header · required

The pixel id the request targets.

Body

application/json

method · enum<string> · required

Shipping cost attribution method.

• shopify_charges — use the shipping charge captured on each order.
• fixed_rate — apply a flat per-order amount (fixedRateAmount required).
• shipping_profiles — match shipping zones / weights configured in Shopify.

Available options: shopify_charges, fixed_rate, shipping_profiles

fixedRateAmount · number

Required when method=fixed_rate. Applied as the per-order shipping cost.

Required range: x >= 0

currency · string

ISO currency code (e.g. USD).

Response

200

application/json

The updated shipping configuration.

config · object · required