v1

latestOpenAPI 3.1.02026-07-2277219695.0 KB

Carrier Accounts

Create a new carrier account

Creates a new carrier account or connects an existing carrier account to the Shippo account.

post/carrier_accounts

Headers

SHIPPO-API-VERSIONstring

Example:2018-02-08

Optional string used to pick a non-default API version to use. See our API version guide.

Request body

account_idstring required

activeboolean

carrierstring required

metadatastring

testboolean

Example request

{
  "account_id": "321123",
  "carrier": "fedex",
  "metadata": "FEDEX Account",
  "parameters": {
    "verification_invoice_amount": "340",
    "verification_invoice_date": "2024-03-09",
    "verification_invoice_currency": "USD"
  }
}

Response

Carrier account

account_idstring required

Unique identifier of the account. Please check the carrier accounts tutorial page for the account_id per carrier. To protect account information, this field will be masked in any API response.

activeboolean

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.

carrierstring required

Carrier token, see Carriers Please check the carrier accounts tutorial page for all supported carriers.

carrier_namestring

Carrier name, see Carriers

is_shippo_accountboolean

metadatastring

object_idstring

Unique identifier of the carrier account object.

object_ownerstring

Username of the user who created the carrier account object.

testboolean

Indicates whether the object has been created in test mode.

Example response

{
  "account_id": "****",
  "carrier": "usps",
  "parameters": {
    "verification_invoice_amount": "340",
    "verification_invoice_date": "2024-03-09",
    "verification_invoice_currency": "USD"
  },
  "carrier_name": "USPS",
  "object_id": "6aa34d5f6865448fbb1ee93636e98999",
  "object_owner": "bob+22@gmail.com",
  "service_levels": [
    {
      "name": "Priority Mail Express",
      "token": "usps_priority_express",
      "supports_return_labels": true
    }
  ]
}