# Create a new shipping/delivery profile (V3)

Creates a new shipping or delivery profile for subscription orders using the V3 request format. This is the latest version with the most comprehensive delivery profile configuration capabilities.

Enhancements in V3:
- Full support for all Shopify delivery profile features
- Advanced rate calculation options
- Support for weight-based and price-based rates
- Enhanced zone and country management
- Better handling of delivery conditions and rules

Key Features:
- Define complex shipping rate structures
- Configure multiple delivery methods per zone
- Set up conditional rates based on weight, price, or item count
- Manage detailed shipping zones with province-level granularity
- Full control over delivery profile settings

Authentication: Requires valid X-API-Key header

Endpoint: POST /api/external/v2/delivery-profiles/v3/create-shipping-profile
Version: 0.0.1

## Query parameters:

  - `api_key` (string)
    API Key (Deprecated - Use Header X-API-Key instead)

## Header parameters:

  - `X-API-Key` (string)

## Request fields (application/json):

  - `name` (string)

  - `sellingPlanGroups` (array)

  - `sellingPlanGroups.label` (string)

  - `sellingPlanGroups.value` (string)

  - `locations` (array)

  - `zones` (array)

  - `zones.countries` (array)

  - `zones.countries.includeAllProvinces` (boolean)

  - `zones.countries.provinces` (array)

  - `zones.restOfWorld` (boolean)

  - `zones.deliveryMethods` (array)

  - `zones.deliveryMethods.amount` (number)

  - `zones.deliveryMethods.deliveryConditionType` (string)

  - `zones.deliveryMethods.currencyCode` (string)
    Enum: "USD", "EUR", "GBP", "CAD", "AFN", "ALL", "DZD", "AOA", "ARS", "AMD", "AWG", "AUD", "BBD", "AZN", "BDT", "BSD", "BHD", "BIF", "BYN", "BZD", "BMD", "BTN", "BAM", "BRL", "BOB", "BWP", "BND", "BGN", "MMK", "KHR", "CVE", "KYD", "XAF", "CLP", "CNY", "COP", "KMF", "CDF", "CRC", "HRK", "CZK", "DKK", "DJF", "DOP", "XCD", "EGP", "ERN", "ETB", "FKP", "XPF", "FJD", "GIP", "GMD", "GHS", "GTQ", "GYD", "GEL", "GNF", "HTG", "HNL", "HKD", "HUF", "ISK", "INR", "IDR", "ILS", "IRR", "IQD", "JMD", "JPY", "JEP", "JOD", "KZT", "KES", "KID", "KWD", "KGS", "LAK", "LVL", "LBP", "LSL", "LRD", "LYD", "LTL", "MGA", "MKD", "MOP", "MWK", "MVR", "MRU", "MXN", "MYR", "MUR", "MDL", "MAD", "MNT", "MZN", "NAD", "NPR", "ANG", "NZD", "NIO", "NGN", "NOK", "OMR", "PAB", "PKR", "PGK", "PYG", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "RWF", "WST", "SHP", "SAR", "RSD", "SCR", "SLL", "SGD", "SDG", "SOS", "SYP", "ZAR", "KRW", "SSP", "SBD", "LKR", "SRD", "SZL", "SEK", "CHF", "TWD", "THB", "TJS", "TZS", "TOP", "TTD", "TND", "TRY", "TMT", "UGX", "UAH", "AED", "UYU", "UZS", "VUV", "VES", "VND", "XOF", "YER", "ZMW", "USDC", "BYR", "STD", "STN", "VED", "VEF", "XXX", "$UNKNOWN"

  - `zones.deliveryMethods.minValue` (number)

  - `zones.deliveryMethods.maxValue` (number)

  - `zones.deliveryMethods.weightUnit` (string)

  - `zones.deliveryMethods.definitionType` (string)

  - `zones.deliveryMethods.carrierServiceId` (string)

  - `zones.deliveryMethods.carrierPercentageFee` (number)

  - `zones.deliveryMethods.carrierFixedFee` (number)

  - `id` (string)

  - `profileId` (integer)

  - `locationInfos` (array)

## Response 200 fields (application/json):

  - `name` (string)

  - `sellingPlanGroups` (array)

  - `sellingPlanGroups.label` (string)

  - `sellingPlanGroups.value` (string)

  - `locations` (array)

  - `zones` (array)

  - `zones.countries` (array)

  - `zones.countries.includeAllProvinces` (boolean)

  - `zones.countries.provinces` (array)

  - `zones.restOfWorld` (boolean)

  - `zones.deliveryMethods` (array)

  - `zones.deliveryMethods.amount` (number)

  - `zones.deliveryMethods.deliveryConditionType` (string)

  - `zones.deliveryMethods.currencyCode` (string)
    Enum: "USD", "EUR", "GBP", "CAD", "AFN", "ALL", "DZD", "AOA", "ARS", "AMD", "AWG", "AUD", "BBD", "AZN", "BDT", "BSD", "BHD", "BIF", "BYN", "BZD", "BMD", "BTN", "BAM", "BRL", "BOB", "BWP", "BND", "BGN", "MMK", "KHR", "CVE", "KYD", "XAF", "CLP", "CNY", "COP", "KMF", "CDF", "CRC", "HRK", "CZK", "DKK", "DJF", "DOP", "XCD", "EGP", "ERN", "ETB", "FKP", "XPF", "FJD", "GIP", "GMD", "GHS", "GTQ", "GYD", "GEL", "GNF", "HTG", "HNL", "HKD", "HUF", "ISK", "INR", "IDR", "ILS", "IRR", "IQD", "JMD", "JPY", "JEP", "JOD", "KZT", "KES", "KID", "KWD", "KGS", "LAK", "LVL", "LBP", "LSL", "LRD", "LYD", "LTL", "MGA", "MKD", "MOP", "MWK", "MVR", "MRU", "MXN", "MYR", "MUR", "MDL", "MAD", "MNT", "MZN", "NAD", "NPR", "ANG", "NZD", "NIO", "NGN", "NOK", "OMR", "PAB", "PKR", "PGK", "PYG", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "RWF", "WST", "SHP", "SAR", "RSD", "SCR", "SLL", "SGD", "SDG", "SOS", "SYP", "ZAR", "KRW", "SSP", "SBD", "LKR", "SRD", "SZL", "SEK", "CHF", "TWD", "THB", "TJS", "TZS", "TOP", "TTD", "TND", "TRY", "TMT", "UGX", "UAH", "AED", "UYU", "UZS", "VUV", "VES", "VND", "XOF", "YER", "ZMW", "USDC", "BYR", "STD", "STN", "VED", "VEF", "XXX", "$UNKNOWN"

  - `zones.deliveryMethods.minValue` (number)

  - `zones.deliveryMethods.maxValue` (number)

  - `zones.deliveryMethods.weightUnit` (string)

  - `zones.deliveryMethods.definitionType` (string)

  - `zones.deliveryMethods.carrierServiceId` (string)

  - `zones.deliveryMethods.carrierPercentageFee` (number)

  - `zones.deliveryMethods.carrierFixedFee` (number)

  - `id` (string)

  - `profileId` (integer)

  - `locationInfos` (array)

## Response 400 fields (*/*):

  - `name` (string)

  - `sellingPlanGroups` (array)

  - `sellingPlanGroups.label` (string)

  - `sellingPlanGroups.value` (string)

  - `locations` (array)

  - `zones` (array)

  - `zones.countries` (array)

  - `zones.countries.includeAllProvinces` (boolean)

  - `zones.countries.provinces` (array)

  - `zones.restOfWorld` (boolean)

  - `zones.deliveryMethods` (array)

  - `zones.deliveryMethods.amount` (number)

  - `zones.deliveryMethods.deliveryConditionType` (string)

  - `zones.deliveryMethods.currencyCode` (string)
    Enum: "USD", "EUR", "GBP", "CAD", "AFN", "ALL", "DZD", "AOA", "ARS", "AMD", "AWG", "AUD", "BBD", "AZN", "BDT", "BSD", "BHD", "BIF", "BYN", "BZD", "BMD", "BTN", "BAM", "BRL", "BOB", "BWP", "BND", "BGN", "MMK", "KHR", "CVE", "KYD", "XAF", "CLP", "CNY", "COP", "KMF", "CDF", "CRC", "HRK", "CZK", "DKK", "DJF", "DOP", "XCD", "EGP", "ERN", "ETB", "FKP", "XPF", "FJD", "GIP", "GMD", "GHS", "GTQ", "GYD", "GEL", "GNF", "HTG", "HNL", "HKD", "HUF", "ISK", "INR", "IDR", "ILS", "IRR", "IQD", "JMD", "JPY", "JEP", "JOD", "KZT", "KES", "KID", "KWD", "KGS", "LAK", "LVL", "LBP", "LSL", "LRD", "LYD", "LTL", "MGA", "MKD", "MOP", "MWK", "MVR", "MRU", "MXN", "MYR", "MUR", "MDL", "MAD", "MNT", "MZN", "NAD", "NPR", "ANG", "NZD", "NIO", "NGN", "NOK", "OMR", "PAB", "PKR", "PGK", "PYG", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "RWF", "WST", "SHP", "SAR", "RSD", "SCR", "SLL", "SGD", "SDG", "SOS", "SYP", "ZAR", "KRW", "SSP", "SBD", "LKR", "SRD", "SZL", "SEK", "CHF", "TWD", "THB", "TJS", "TZS", "TOP", "TTD", "TND", "TRY", "TMT", "UGX", "UAH", "AED", "UYU", "UZS", "VUV", "VES", "VND", "XOF", "YER", "ZMW", "USDC", "BYR", "STD", "STN", "VED", "VEF", "XXX", "$UNKNOWN"

  - `zones.deliveryMethods.minValue` (number)

  - `zones.deliveryMethods.maxValue` (number)

  - `zones.deliveryMethods.weightUnit` (string)

  - `zones.deliveryMethods.definitionType` (string)

  - `zones.deliveryMethods.carrierServiceId` (string)

  - `zones.deliveryMethods.carrierPercentageFee` (number)

  - `zones.deliveryMethods.carrierFixedFee` (number)

  - `id` (string)

  - `profileId` (integer)

  - `locationInfos` (array)

## Response 401 fields (*/*):

  - `name` (string)

  - `sellingPlanGroups` (array)

  - `sellingPlanGroups.label` (string)

  - `sellingPlanGroups.value` (string)

  - `locations` (array)

  - `zones` (array)

  - `zones.countries` (array)

  - `zones.countries.includeAllProvinces` (boolean)

  - `zones.countries.provinces` (array)

  - `zones.restOfWorld` (boolean)

  - `zones.deliveryMethods` (array)

  - `zones.deliveryMethods.amount` (number)

  - `zones.deliveryMethods.deliveryConditionType` (string)

  - `zones.deliveryMethods.currencyCode` (string)
    Enum: "USD", "EUR", "GBP", "CAD", "AFN", "ALL", "DZD", "AOA", "ARS", "AMD", "AWG", "AUD", "BBD", "AZN", "BDT", "BSD", "BHD", "BIF", "BYN", "BZD", "BMD", "BTN", "BAM", "BRL", "BOB", "BWP", "BND", "BGN", "MMK", "KHR", "CVE", "KYD", "XAF", "CLP", "CNY", "COP", "KMF", "CDF", "CRC", "HRK", "CZK", "DKK", "DJF", "DOP", "XCD", "EGP", "ERN", "ETB", "FKP", "XPF", "FJD", "GIP", "GMD", "GHS", "GTQ", "GYD", "GEL", "GNF", "HTG", "HNL", "HKD", "HUF", "ISK", "INR", "IDR", "ILS", "IRR", "IQD", "JMD", "JPY", "JEP", "JOD", "KZT", "KES", "KID", "KWD", "KGS", "LAK", "LVL", "LBP", "LSL", "LRD", "LYD", "LTL", "MGA", "MKD", "MOP", "MWK", "MVR", "MRU", "MXN", "MYR", "MUR", "MDL", "MAD", "MNT", "MZN", "NAD", "NPR", "ANG", "NZD", "NIO", "NGN", "NOK", "OMR", "PAB", "PKR", "PGK", "PYG", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "RWF", "WST", "SHP", "SAR", "RSD", "SCR", "SLL", "SGD", "SDG", "SOS", "SYP", "ZAR", "KRW", "SSP", "SBD", "LKR", "SRD", "SZL", "SEK", "CHF", "TWD", "THB", "TJS", "TZS", "TOP", "TTD", "TND", "TRY", "TMT", "UGX", "UAH", "AED", "UYU", "UZS", "VUV", "VES", "VND", "XOF", "YER", "ZMW", "USDC", "BYR", "STD", "STN", "VED", "VEF", "XXX", "$UNKNOWN"

  - `zones.deliveryMethods.minValue` (number)

  - `zones.deliveryMethods.maxValue` (number)

  - `zones.deliveryMethods.weightUnit` (string)

  - `zones.deliveryMethods.definitionType` (string)

  - `zones.deliveryMethods.carrierServiceId` (string)

  - `zones.deliveryMethods.carrierPercentageFee` (number)

  - `zones.deliveryMethods.carrierFixedFee` (number)

  - `id` (string)

  - `profileId` (integer)

  - `locationInfos` (array)

## Response 403 fields (*/*):

  - `name` (string)

  - `sellingPlanGroups` (array)

  - `sellingPlanGroups.label` (string)

  - `sellingPlanGroups.value` (string)

  - `locations` (array)

  - `zones` (array)

  - `zones.countries` (array)

  - `zones.countries.includeAllProvinces` (boolean)

  - `zones.countries.provinces` (array)

  - `zones.restOfWorld` (boolean)

  - `zones.deliveryMethods` (array)

  - `zones.deliveryMethods.amount` (number)

  - `zones.deliveryMethods.deliveryConditionType` (string)

  - `zones.deliveryMethods.currencyCode` (string)
    Enum: "USD", "EUR", "GBP", "CAD", "AFN", "ALL", "DZD", "AOA", "ARS", "AMD", "AWG", "AUD", "BBD", "AZN", "BDT", "BSD", "BHD", "BIF", "BYN", "BZD", "BMD", "BTN", "BAM", "BRL", "BOB", "BWP", "BND", "BGN", "MMK", "KHR", "CVE", "KYD", "XAF", "CLP", "CNY", "COP", "KMF", "CDF", "CRC", "HRK", "CZK", "DKK", "DJF", "DOP", "XCD", "EGP", "ERN", "ETB", "FKP", "XPF", "FJD", "GIP", "GMD", "GHS", "GTQ", "GYD", "GEL", "GNF", "HTG", "HNL", "HKD", "HUF", "ISK", "INR", "IDR", "ILS", "IRR", "IQD", "JMD", "JPY", "JEP", "JOD", "KZT", "KES", "KID", "KWD", "KGS", "LAK", "LVL", "LBP", "LSL", "LRD", "LYD", "LTL", "MGA", "MKD", "MOP", "MWK", "MVR", "MRU", "MXN", "MYR", "MUR", "MDL", "MAD", "MNT", "MZN", "NAD", "NPR", "ANG", "NZD", "NIO", "NGN", "NOK", "OMR", "PAB", "PKR", "PGK", "PYG", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "RWF", "WST", "SHP", "SAR", "RSD", "SCR", "SLL", "SGD", "SDG", "SOS", "SYP", "ZAR", "KRW", "SSP", "SBD", "LKR", "SRD", "SZL", "SEK", "CHF", "TWD", "THB", "TJS", "TZS", "TOP", "TTD", "TND", "TRY", "TMT", "UGX", "UAH", "AED", "UYU", "UZS", "VUV", "VES", "VND", "XOF", "YER", "ZMW", "USDC", "BYR", "STD", "STN", "VED", "VEF", "XXX", "$UNKNOWN"

  - `zones.deliveryMethods.minValue` (number)

  - `zones.deliveryMethods.maxValue` (number)

  - `zones.deliveryMethods.weightUnit` (string)

  - `zones.deliveryMethods.definitionType` (string)

  - `zones.deliveryMethods.carrierServiceId` (string)

  - `zones.deliveryMethods.carrierPercentageFee` (number)

  - `zones.deliveryMethods.carrierFixedFee` (number)

  - `id` (string)

  - `profileId` (integer)

  - `locationInfos` (array)

## Response 422 fields (*/*):

  - `name` (string)

  - `sellingPlanGroups` (array)

  - `sellingPlanGroups.label` (string)

  - `sellingPlanGroups.value` (string)

  - `locations` (array)

  - `zones` (array)

  - `zones.countries` (array)

  - `zones.countries.includeAllProvinces` (boolean)

  - `zones.countries.provinces` (array)

  - `zones.restOfWorld` (boolean)

  - `zones.deliveryMethods` (array)

  - `zones.deliveryMethods.amount` (number)

  - `zones.deliveryMethods.deliveryConditionType` (string)

  - `zones.deliveryMethods.currencyCode` (string)
    Enum: "USD", "EUR", "GBP", "CAD", "AFN", "ALL", "DZD", "AOA", "ARS", "AMD", "AWG", "AUD", "BBD", "AZN", "BDT", "BSD", "BHD", "BIF", "BYN", "BZD", "BMD", "BTN", "BAM", "BRL", "BOB", "BWP", "BND", "BGN", "MMK", "KHR", "CVE", "KYD", "XAF", "CLP", "CNY", "COP", "KMF", "CDF", "CRC", "HRK", "CZK", "DKK", "DJF", "DOP", "XCD", "EGP", "ERN", "ETB", "FKP", "XPF", "FJD", "GIP", "GMD", "GHS", "GTQ", "GYD", "GEL", "GNF", "HTG", "HNL", "HKD", "HUF", "ISK", "INR", "IDR", "ILS", "IRR", "IQD", "JMD", "JPY", "JEP", "JOD", "KZT", "KES", "KID", "KWD", "KGS", "LAK", "LVL", "LBP", "LSL", "LRD", "LYD", "LTL", "MGA", "MKD", "MOP", "MWK", "MVR", "MRU", "MXN", "MYR", "MUR", "MDL", "MAD", "MNT", "MZN", "NAD", "NPR", "ANG", "NZD", "NIO", "NGN", "NOK", "OMR", "PAB", "PKR", "PGK", "PYG", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "RWF", "WST", "SHP", "SAR", "RSD", "SCR", "SLL", "SGD", "SDG", "SOS", "SYP", "ZAR", "KRW", "SSP", "SBD", "LKR", "SRD", "SZL", "SEK", "CHF", "TWD", "THB", "TJS", "TZS", "TOP", "TTD", "TND", "TRY", "TMT", "UGX", "UAH", "AED", "UYU", "UZS", "VUV", "VES", "VND", "XOF", "YER", "ZMW", "USDC", "BYR", "STD", "STN", "VED", "VEF", "XXX", "$UNKNOWN"

  - `zones.deliveryMethods.minValue` (number)

  - `zones.deliveryMethods.maxValue` (number)

  - `zones.deliveryMethods.weightUnit` (string)

  - `zones.deliveryMethods.definitionType` (string)

  - `zones.deliveryMethods.carrierServiceId` (string)

  - `zones.deliveryMethods.carrierPercentageFee` (number)

  - `zones.deliveryMethods.carrierFixedFee` (number)

  - `id` (string)

  - `profileId` (integer)

  - `locationInfos` (array)