Create Carrier Connection

Creates a Carrier Connection.

Carrier connections refer to specific settings required to connect to a specific shipping carrier. Each carrier requires your app to supply a unique set of properties/fields to establish a connection with that carrier.

Notes:

• There is no GET with this resource. It has PUT, POST and DELETE.

  • PUT is used to update. The connection can be updated by API.

• Connections created here do not enable the shipping method. To enable the carrier for a shipping zone, use the Shipping Methods API.

• The Carrier Connection resource returns a 204 for both successful and unsuccessful attempts to connect. If a field is missing, it will return a 400.

Australia Post

PUT or POST example request:

{
  "carrier_id" : "auspost",
  "connection" : {
    "auth_key" : "yourAusPostAuthKey",
    "test_mode" : false
  }
}

DELETE example request:

{
  "carrier_id" : "auspost"
}

Australia Post Connection Object – Properties

Australia Post PUT or POST requests require all of the following properties. (These requests won’t be fulfilled unless these properties are valid.) DELETE requests require only a carrier_id.

Endicia

USPS is connected through Endicia.

PUT or POST example request:

{  "carrier_id" : "endicia",
  "connection": {
    "account_id" : "yourEndiciaAccountId",
    "pass_phrase" : "yourEndiciaPassphrase"
  }
}

DELETE example request:

{
  "carrier_id" : "endicia"
}

Endicia Connection Object – Properties

Endicia PUT or POST requests require all of the following properties. (These requests won’t be fulfilled unless these properties are valid.) DELETE requests require only a carrier_id.

FedEx

PUT or POST example request:

{
  "carrier_id" : "fedex",
  "connection" : {
    "key" : "yourFedexKey",
    "password" : "yourFedexPassword",
    "account_number" : "yourFedexAccountNumber",
    "meter_number" : "yourFedexMeterNumber"
  }
}

DELETE example request:

{
  "carrier_id" : "fedex"
}

FedEx Connection Object – Properties

FedEx PUT or POST requests require all of the following properties. (These requests won’t be fulfilled unless these properties are valid.) DELETE requests require only a carrier_id.

Royal Mail

PUT or POST example request:

{
    "carrier_id" : "royalmail",
    "connection" : {
    }
}

DELETE example request:

{
    "carrier_id" : "royalmail"
}

Royal Mail Connection Object - Properties

Royal Mail has no connection object properties.

Shipping Provider API

Please note that this endpoint is not intended for adding connection settings.

Its purpose is solely to establish a connection between your BigCommerce store and the carrier. If the carrier has no connection settings configured, please leave the connection property empty. However, if the carrier already has connection settings configured, you can utilize this endpoint to establish the connection using the existing connection properties.

PUT or POST example request when your carrier is not configured with any connection settings:

{
  "carrier_id" : "carrier_{your_carrier_id}",
  "connection" : {}
}

PUT or POST example request when your carrier is configured with connection settings:

{
  "carrier_id" : "carrier_{your_carrier_id}",
  "connection" : {
    "your_configured_key_1": "value_1",
    "your_configured_key_2": "value_2
  }
}

Zoom2U

PUT or POST example request:

{
  "carrier_id" : "zoom2u",
  "connection" : {
    "auth_key" : "yourZoom2uAuthKey",
    "test_mode" : false
  }
}

DELETE example request:

{
  "carrier_id" : "zoom2u"
}

Zoom2U Connection Object – Properties

Zoom2U PUT or POST requests require all of the following properties. (These requests won’t be fulfilled unless these properties are valid.) DELETE requests require only a carrier_id.