/shippo-management | Type: Application | PCID required: Yes
Tools
shippo_management_create_carrier_account
Create a new carrier account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
account_id | string | Yes | — | Account Id |
active | boolean | No | — | The active value |
carrier | string | Yes | — | The carrier value |
metadata | string | No | — | The metadata value |
parameters | object | Yes | — | The parameters value |
test | boolean | No | — | The test value |
shippo_management_create_customs_declaration
Create a new customs declaration Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address_importer | object | No | — | Object that represents the address of the importer |
aes_itn | string | No | — | required if eel_pfc is AES_ITN<br> AES / ITN reference of the shipment. |
b13a_filing_option | object | No | — | B13a Filing Option |
b13a_number | string | No | — | must be provided if and only if b13a_filing_option is provided<br> Represents:<br> the Proof of Report (POR) Number when b13a_filing_option is FILED_ELECTRONICALLY;<br> the Summary ID Number when b13a_filing_option is SUMMARY_REPORTING;<br> or the Exemption Number when b13a_filing_option is NOT_REQUIRED. |
certificate | string | No | — | Certificate reference of the shipment. |
certify | boolean | Yes | — | Expresses that the certify_signer has provided all information of this customs declaration truthfully. |
certify_signer | string | Yes | — | Name of the person who created the customs declaration and is responsible for the validity of all information provided. |
commercial_invoice | boolean | No | — | Commercial Invoice |
contents_explanation | string | No | — | required if contents_type is OTHER<br> Explanation of the type of goods of the shipment. |
contents_type | object | Yes | — | Contents Type |
disclaimer | string | No | — | Disclaimer for the shipment and customs information that have been provided. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Max 554 characters | |
duties_payor | object | No | — | Specifies who will pay the duties for the shipment. Only accepted for FedEx shipments. |
eel_pfc | object | No | — | Eel Pfc |
exporter_identification | object | No | — | Additional exporter identification that may be required to ship in certain countries |
exporter_reference | string | No | — | Exporter reference of an export shipment. |
importer_reference | string | No | — | Importer reference of an import shipment. |
incoterm | object | No | — | The incoterm value |
invoice | string | No | — | Invoice reference of the shipment. |
is_vat_collected | boolean | No | — | Indicates whether the shipment’s destination VAT has been collected. May be required for some destinations. |
items | any[] | Yes | — | The items value |
license | string | No | — | License reference of the shipment. |
metadata | string | No | — | A string of up to 100 characters that can be filled with any additional information you want to attach to the object. |
non_delivery_option | object | Yes | — | Non Delivery Option |
notes | string | No | — | Additional notes to be included in the customs declaration. |
test | boolean | No | — | The test value |
shippo_management_create_customs_item
Create a new customs item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
description | string | Yes | — | Text description of your item. |
eccn_ear99 | string | No | — | Export Control Classification Number, required on some exports from the United States. |
hs_code | string | No | — | HS code of the item, which is required by some carriers. If tariff_number is not provided, hs_code will be used. If both hs_code and tariff_number are provided, tariff_number will be used. 50 character limit. |
mass_unit | string | Yes | — | The unit used for weight. |
metadata | string | No | — | A string of up to 100 characters that can be filled with any additional information you want to attach to the object. |
net_weight | string | Yes | — | Total weight of this item, i.e. quantity * weight per item. |
origin_country | string | Yes | — | Country of origin of the item. Example: US or DE. All accepted values can be found on the <a href=“http://www.iso.org/” target=“_blank”>Official ISO Website</a>. |
quantity | integer | Yes | — | Quantity of this item in the shipment you send. Must be greater than 0. |
sku_code | string | No | — | SKU code of the item, which is required by some carriers. |
tariff_number | string | No | — | The tariff number of the item. If tariff_number is not provided, hs_code will be used. If both hs_code and tariff_number are provided, tariff_number will be used. 12 character limit. |
value_amount | string | Yes | — | Total value of this item, i.e. quantity * value per item. |
value_currency | string | Yes | — | Currency used for value_amount. The <a href=“http://www.xe.com/iso4217.php”>official ISO 4217</a> currency codes are used, e.g. USD or EUR. |
shippo_management_create_service_group
Create a new service group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
description | string | Yes | — | Description for the service group |
flat_rate | string | No | — | String representation of an amount to be returned as the flat rate if 1. The service group is of type LIVE_RATE and no matching rates were found; or 2. The service group is of type FLAT_RATE. Either integers or decimals are accepted. Required unless type is FREE_SHIPPING |
flat_rate_currency | string | No | — | required unless type is FREE_SHIPPING. (ISO 4217 currency) |
free_shipping_threshold_currency | string | No | — | optional unless type is FREE_SHIPPING. (ISO 4217 currency) |
free_shipping_threshold_min | string | No | — | For service groups of type FREE_SHIPPING, this field must be required to configure the minimum cart total (total cost of items in the cart) for this service group to be returned for rates at checkout. Optional unless type is FREE_SHIPPING |
name | string | Yes | — | Name for the service group that will be shown to customers in the response |
rate_adjustment | integer | No | — | The amount in percent (%) that the service group’s returned rate should be adjusted. For example, if this field is set to 5 and the matched rate price is 5.25. Negative integers are also accepted and will discount the rate price by the defined percentage amount. |
service_levels | object[] | Yes | — | Service Levels |
type | string | Yes | — | The type of the service group.<br> LIVE_RATE - Shippo will make a rating request and return real-time rates for the shipping group, only falling back to the specified flat rate amount if no rates match a service level in the service group.<br> FLAT_RATE - Returns a shipping option with the specified flat rate amount.<br> FREE_SHIPPING - Returns a shipping option with a price of $0 only if the total cost of items exceeds the amount defined by free_shipping_threshold_min |
shippo_management_create_shippo_account
Create a Shippo Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_name | string | No | — | Company Name |
email | string | No | — | The email value |
first_name | string | No | — | First Name |
last_name | string | No | — | Last Name |
shippo_management_create_track
Register a tracking webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
carrier | string | Yes | — | Name of the carrier of the shipment to track. |
metadata | string | No | — | A string of up to 100 characters that can be filled with any additional information you want to attach to the object. |
tracking_number | string | Yes | — | Tracking number to track. |
shippo_management_create_user_parcel_template
Create a new user parcel template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
body | object | Yes | — | Request body |
shippo_management_create_webhook
Create a new webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
active | boolean | No | — | Determines whether the webhook is active or not. |
event | string | Yes | — | Type of event that triggered the webhook. |
is_test | boolean | No | — | Determines whether the webhook is a test webhook or not. |
url | string | Yes | — | URL webhook events are sent to. |
shippo_management_delete_service_group
Delete a service group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ServiceGroupId | string | Yes | — | Object ID of the service group |
shippo_management_delete_user_parcel_template
Delete a user parcel template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
UserParcelTemplateObjectId | string | Yes | — | Object ID of the user parcel template |
shippo_management_delete_webhook
Delete a specific webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
webhookId | string | Yes | — | Object ID of the webhook to delete |
shippo_management_get_account
Retrieve a Shippo Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ShippoAccountId | string | Yes | — | Object ID of the ShippoAccount |
shippo_management_get_carrier_account
Retrieve a carrier account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
CarrierAccountId | string | Yes | — | Object ID of the carrier account |
shippo_management_get_carrier_parcel_template
Retrieve a carrier parcel templates Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
CarrierParcelTemplateToken | string | Yes | — | The unique string representation of the carrier parcel template |
shippo_management_get_carrier_registration_status
Get Carrier Registration status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
carrier | string | Yes | — | filter by specific carrier |
shippo_management_get_customs_declaration
Retrieve a customs declaration Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
CustomsDeclarationId | string | Yes | — | Object ID of the customs declaration |
page | integer | No | — | The page number you want to select |
shippo_management_get_customs_item
Retrieve a customs item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
CustomsItemId | string | Yes | — | Object ID of the customs item |
page | integer | No | — | The page number you want to select |
shippo_management_get_track
Get a tracking status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
TrackingNumber | string | Yes | — | Tracking number |
Carrier | string | Yes | — | Name of the carrier |
shippo_management_get_user_parcel_template
Retrieves a user parcel template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
UserParcelTemplateObjectId | string | Yes | — | Object ID of the user parcel template |
shippo_management_get_webhook
Retrieve a specific webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
webhookId | string | Yes | — | Object ID of the webhook to retrieve |
shippo_management_initiate_oauth2signin
Connect an existing carrier account using OAuth 2.0 Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
CarrierAccountObjectId | string | Yes | — | The carrier account ID (UUID) to start a signin process. |
redirect_uri | string | Yes | — | Callback URL. The URL that tells the authorization server where to send the user back to after they approve the request. |
state | string | No | — | A random string generated by the consuming application and included in the request to prevent CSRF attacks. The consuming application checks that the same value is returned after the user authorizes Shippo. |
shippo_management_list_carrier_accounts
List all carrier accounts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
service_levels | boolean | No | — | Appends the property service_levels to each returned carrier account |
carrier | string | No | — | Filter the response by the specified carrier |
account_id | string | No | — | Filter the response by the specified carrier account Id |
page | integer | No | — | The page number you want to select |
results | integer | No | — | The number of results to return per page (max 100, default 5) |
shippo_management_list_carrier_parcel_templates
List all carrier parcel templates Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
include | string | No | — | filter by user or enabled |
carrier | string | No | — | filter by specific carrier |
shippo_management_list_customs_declarations
List all customs declarations Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | The page number you want to select |
results | integer | No | — | The number of results to return per page (max 100, default 5) |
shippo_management_list_customs_items
List all customs items Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | The page number you want to select |
results | integer | No | — | The number of results to return per page (max 100) |
shippo_management_list_service_groups
List all service groupsshippo_management_list_shippo_accounts
List all Shippo Accounts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | The page number you want to select |
results | integer | No | — | The number of results to return per page (max 100) |
shippo_management_list_user_parcel_templates
List all user parcel templatesshippo_management_list_webhooks
List all webhooksshippo_management_register_carrier_account
Add a Shippo carrier account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
body | object | Yes | — | The body of the request. |
shippo_management_update_carrier_account
Update a carrier account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
CarrierAccountId | string | Yes | — | Object ID of the carrier account |
account_id | string | Yes | — | Unique identifier of the account. Please check the <a href=“https://docs.goshippo.com/docs/carriers/carrieraccounts/“>carrier accounts tutorial</a> page for the account_id per carrier.<br> To protect account information, this field will be masked in any API response. |
active | boolean | No | — | Determines whether the account is active. When creating a shipment, if no carrier_accounts are explicitly passed Shippo will query all carrier accounts that have this field set. By default, this is set to True. |
carrier | string | Yes | — | Carrier token, see <a href=“/shippoapi/public-api/carriers”>Carriers</a><br> Please check the <a href=“https://docs.goshippo.com/docs/carriers/carrieraccounts/“>carrier accounts tutorial</a> page for all supported carriers. |
parameters | object | No | — | The parameters value |
shippo_management_update_service_group
Update an existing service group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
description | string | Yes | — | Description for the service group |
flat_rate | string | No | — | String representation of an amount to be returned as the flat rate if 1. The service group is of type LIVE_RATE and no matching rates were found; or 2. The service group is of type FLAT_RATE. Either integers or decimals are accepted. Required unless type is FREE_SHIPPING |
flat_rate_currency | string | No | — | required unless type is FREE_SHIPPING. (ISO 4217 currency) |
free_shipping_threshold_currency | string | No | — | optional unless type is FREE_SHIPPING. (ISO 4217 currency) |
free_shipping_threshold_min | string | No | — | For service groups of type FREE_SHIPPING, this field must be required to configure the minimum cart total (total cost of items in the cart) for this service group to be returned for rates at checkout. Optional unless type is FREE_SHIPPING |
is_active | boolean | Yes | — | True if the service group is enabled, false otherwise. |
name | string | Yes | — | Name for the service group that will be shown to customers in the response |
object_id | string | Yes | — | The unique identifier of the given Service Group object. |
rate_adjustment | integer | No | — | The amount in percent (%) that the service group’s returned rate should be adjusted. For example, if this field is set to 5 and the matched rate price is 5.25. Negative integers are also accepted and will discount the rate price by the defined percentage amount. |
service_levels | object[] | Yes | — | Service Levels |
type | string | Yes | — | The type of the service group.<br> LIVE_RATE - Shippo will make a rating request and return real-time rates for the shipping group, only falling back to the specified flat rate amount if no rates match a service level in the service group.<br> FLAT_RATE - Returns a shipping option with the specified flat rate amount.<br> FREE_SHIPPING - Returns a shipping option with a price of $0 only if the total cost of items exceeds the amount defined by free_shipping_threshold_min |
shippo_management_update_shippo_account
Update a Shippo Account Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
ShippoAccountId | string | Yes | — | Object ID of the ShippoAccount |
company_name | string | No | — | Company Name |
email | string | No | — | The email value |
first_name | string | No | — | First Name |
last_name | string | No | — | Last Name |
shippo_management_update_user_parcel_template
Update an existing user parcel template Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
UserParcelTemplateObjectId | string | Yes | — | Object ID of the user parcel template |
distance_unit | string | Yes | — | The measure unit used for length, width and height. |
height | string | Yes | — | The height of the package, in units specified by the distance_unit attribute. Required, but if using a preset carrier template then this field must be empty. |
length | string | Yes | — | The length of the package, in units specified by the distance_unit attribute. Required, but if using a preset carrier template then this field must be empty. |
name | string | Yes | — | The name of the User Parcel Template |
weight | string | No | — | The weight of the package, in units specified by the weight_unit attribute. |
weight_unit | string | No | — | The unit used for weight. |
width | string | Yes | — | The width of the package, in units specified by the distance_unit attribute. Required, but if using a preset carrier template then this field must be empty. |
shippo_management_update_webhook
Update an existing webhook Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
webhookId | string | Yes | — | Object ID of the webhook to retrieve |
active | boolean | No | — | Determines whether the webhook is active or not. |
event | string | Yes | — | Type of event that triggered the webhook. |
is_test | boolean | No | — | Determines whether the webhook is a test webhook or not. |
url | string | Yes | — | URL webhook events are sent to. |

