---
title: "Create a rate"
method: POST
path: "/shipping/{connection_id}/rate"
tags: ["shipping", "rate"]
---

# Create a rate

`POST /shipping/{connection_id}/rate`

## Path parameters

- `connection_id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- ShippingRate
  - `shipment_id` string
  - `currency` string
  - `from_address` PropertyShippingRateFromAddress — Origin address
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
    - `name` string
    - `company_name` string
    - `telephone` string
    - `email` string
    - `is_residential` boolean
    - `is_validated` boolean
    - `delivery_instructions` string
  - `to_address` PropertyShippingRateToAddress — Destination address
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
    - `name` string
    - `company_name` string
    - `telephone` string
    - `email` string
    - `is_residential` boolean
    - `is_validated` boolean
    - `delivery_instructions` string
  - `packages` ShippingPackage[] — Multiple packages (alternative to package)
    - `weight` number
    - `weight_unit` 'g' | 'kg' | 'oz' | 'lb'
    - `length` number
    - `width` number
    - `height` number
    - `size_unit` 'cm' | 'inch'
    - `description` string
    - `value` number
    - `currency` string
    - `tracking_number` string
    - `insured_amount` number
  - `ship_by_at` string, date-time
  - `carrier_id` string
  - `id` string
  - `rates` ShippingRateRate[]
    - `title` string, required
    - `description` string
    - `amount` number
    - `currency` string
    - `base_amount` number
    - `tax_amount` number
    - `discount_amount` number
    - `surcharges` ShippingRateSurcharge[] — Additional charges
      - `code` string
      - `name` string
      - `amount` number
      - `description` string
    - `rate_source` string
    - `is_negotiated_rate` boolean
    - `estimated_days` number
    - `delivery_days` number
    - `estimated_delivery_end_at` string, date-time
    - `estimated_delivery_start_at` string, date-time
    - `delivery_terms` string
    - `transit_hours` number
    - `is_guaranteed` boolean
    - `package_type` string
    - `is_trackable` boolean
    - `is_active` boolean
  - `raw` object

## Response `200`

Successful

- ShippingRate
  - `shipment_id` string
  - `currency` string
  - `from_address` PropertyShippingRateFromAddress — Origin address
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
    - `name` string
    - `company_name` string
    - `telephone` string
    - `email` string
    - `is_residential` boolean
    - `is_validated` boolean
    - `delivery_instructions` string
  - `to_address` PropertyShippingRateToAddress — Destination address
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
    - `name` string
    - `company_name` string
    - `telephone` string
    - `email` string
    - `is_residential` boolean
    - `is_validated` boolean
    - `delivery_instructions` string
  - `packages` ShippingPackage[] — Multiple packages (alternative to package)
    - `weight` number
    - `weight_unit` 'g' | 'kg' | 'oz' | 'lb'
    - `length` number
    - `width` number
    - `height` number
    - `size_unit` 'cm' | 'inch'
    - `description` string
    - `value` number
    - `currency` string
    - `tracking_number` string
    - `insured_amount` number
  - `ship_by_at` string, date-time
  - `carrier_id` string
  - `id` string
  - `rates` ShippingRateRate[]
    - `title` string, required
    - `description` string
    - `amount` number
    - `currency` string
    - `base_amount` number
    - `tax_amount` number
    - `discount_amount` number
    - `surcharges` ShippingRateSurcharge[] — Additional charges
      - `code` string
      - `name` string
      - `amount` number
      - `description` string
    - `rate_source` string
    - `is_negotiated_rate` boolean
    - `estimated_days` number
    - `delivery_days` number
    - `estimated_delivery_end_at` string, date-time
    - `estimated_delivery_start_at` string, date-time
    - `delivery_terms` string
    - `transit_hours` number
    - `is_guaranteed` boolean
    - `package_type` string
    - `is_trackable` boolean
    - `is_active` boolean
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/revisions/fecb148873a5/schema)