Add a carrier connection

POST /v1/connections

Add a new carrier connection.

Request

application/json

Body

required

carrier_name stringrequired

Possible values: [allied_express, allied_express_local, amazon_shipping, aramex, asendia_us, australiapost, boxknight, bpost, canadapost, canpar, chronopost, colissimo, dhl_express, dhl_parcel_de, dhl_poland, dhl_universal, dicom, dpd, dpdhl, easypost, eshipper, fedex, fedex_ws, freightcom, generic, geodis, hay_post, laposte, locate2u, nationex, purolator, roadie, royalmail, sapient, seko, sendle, tge, tnt, ups, usps, usps_international, usps_wt, usps_wt_international, zoom2u]

A carrier connection type.

carrier_id stringrequired

A carrier connection friendly name.

credentials

object

required

oneOf

api_key stringrequired

client_id stringrequired

client_secret stringrequired

shipping_account_id stringrequired

carrier_code string

Possible values: [DX, EVRI, RM, UPS, YODEL]

Indicates a carrier_code string

username stringrequired

password stringrequired

account_number stringrequired

user_token string

language string

Possible values: [en, fr]

Indicates a language string

api_key stringrequired

customer_id stringrequired

billing_account string

language string

Possible values: [en, fr]

Indicates a language string

api_key stringrequired

lang string

Possible values: [fr_FR, en_US]

Indicates a lang string

api_key stringrequired

identifier stringrequired

code_client string

language string

Possible values: [fr, en]

Indicates a language string

password stringrequired

meter_number stringrequired

account_number stringrequired

user_key string

language_code string

Default value: en

account_country_code string

delis_id stringrequired

password stringrequired

depot string

message_language string

Default value: en_EN

account_country_code string

Default value: BE

consumer_key stringrequired

consumer_secret stringrequired

language string

Possible values: [en, de]

Indicates a language string

account_number stringrequired

password stringrequired

id_emit string

Default value: CHRFR

language string

Possible values: [en_GB, fr_FR]

Indicates a language string

username stringrequired

password stringrequired

language string

Possible values: [en, fr]

Indicates a language string

username stringrequired

password stringrequired

customer_number string

contract_id string

language string

Possible values: [en, fr]

Indicates a language string

seller_id stringrequired

developer_id stringrequired

mws_auth_token stringrequired

aws_region string

Default value: us-east-1

account_country_code string

username stringrequired

password stringrequired

account string

service_type string

Possible values: [R, P, PT, PT2]

Indicates a service_type string

username stringrequired

password stringrequired

account string

service_type string

Possible values: [R, P, PT, PT2]

Indicates a service_type string

capabilities string[]nullable

The carrier enabled capabilities.

config

object

Carrier connection custom config.

property name* any

Default value: [object Object]

Carrier connection custom config.

metadata

object

User metadata for the carrier.

property name* any

Default value: [object Object]

User metadata for the carrier.

active boolean

Default value: true

The active flag indicates whether the carrier account is active or not.

Responses

application/json

Schema
Example (from schema)

Schema

id stringrequired

A unique carrier connection identifier

object_type string

Default value: carrier-connection

Specifies the object type

carrier_name stringrequired

A carrier connection type.

display_name string

The carrier connection type verbose name.

carrier_id stringrequired

A carrier connection friendly name.

credentials

object

oneOf

api_key stringrequired

client_id stringrequired

client_secret stringrequired

shipping_account_id stringrequired

carrier_code string

Possible values: [DX, EVRI, RM, UPS, YODEL]

Indicates a carrier_code string

username stringrequired

password stringrequired

account_number stringrequired

user_token string

language string

Possible values: [en, fr]

Indicates a language string

api_key stringrequired

customer_id stringrequired

billing_account string

language string

Possible values: [en, fr]

Indicates a language string

api_key stringrequired

lang string

Possible values: [fr_FR, en_US]

Indicates a lang string

api_key stringrequired

identifier stringrequired

code_client string

language string

Possible values: [fr, en]

Indicates a language string

password stringrequired

meter_number stringrequired

account_number stringrequired

user_key string

language_code string

Default value: en

account_country_code string

delis_id stringrequired

password stringrequired

depot string

message_language string

Default value: en_EN

account_country_code string

Default value: BE

consumer_key stringrequired

consumer_secret stringrequired

language string

Possible values: [en, de]

Indicates a language string

account_number stringrequired

password stringrequired

id_emit string

Default value: CHRFR

language string

Possible values: [en_GB, fr_FR]

Indicates a language string

username stringrequired

password stringrequired

language string

Possible values: [en, fr]

Indicates a language string

username stringrequired

password stringrequired

customer_number string

contract_id string

language string

Possible values: [en, fr]

Indicates a language string

seller_id stringrequired

developer_id stringrequired

mws_auth_token stringrequired

aws_region string

Default value: us-east-1

account_country_code string

username stringrequired

password stringrequired

account string

service_type string

Possible values: [R, P, PT, PT2]

Indicates a service_type string

username stringrequired

password stringrequired

account string

service_type string

Possible values: [R, P, PT, PT2]

Indicates a service_type string

capabilities string[]nullable

The carrier enabled capabilities.

config

object

Carrier connection custom config.

property name* any

Default value: [object Object]

Carrier connection custom config.

metadata

object

User metadata for the carrier.

property name* any

Default value: [object Object]

User metadata for the carrier.

is_system booleanrequired

The carrier connection is provided by the system admin.

active booleanrequired

The active flag indicates whether the carrier account is active or not.

test_mode booleanrequired

The test flag indicates whether to use a carrier configured for test.

{
  "id": "string",
  "object_type": "carrier-connection",
  "carrier_name": "allied_express",
  "display_name": "string",
  "carrier_id": "string",
  "credentials": {
    "api_key": "string"
  },
  "capabilities": [
    "string"
  ],
  "config": {},
  "metadata": {},
  "is_system": true,
  "active": true,
  "test_mode": true
}

application/json

Schema
Example (from schema)

Schema

errors

object[]

The list of API errors

Array [

message string

The error or warning message

code string

The message code

details

object

any additional details

property name* any

any additional details

]

{
  "errors": [
    {
      "message": "string",
      "code": "string",
      "details": {}
    }
  ]
}

application/json

Schema
Example (from schema)

Schema

messages

object[]

The list of error messages

Array [

message string

The error or warning message

code string

The message code

details

object

any additional details

property name* any

any additional details

carrier_name string

The targeted carrier

carrier_id string

The targeted carrier name (unique identifier)

]

{
  "messages": [
    {
      "message": "string",
      "code": "string",
      "details": {},
      "carrier_name": "string",
      "carrier_id": "string"
    }
  ]
}

application/json

Schema
Example (from schema)

Schema

errors

object[]

The list of API errors

Array [

message string

The error or warning message

code string

The message code

details

object

any additional details

property name* any

any additional details

]

{
  "errors": [
    {
      "message": "string",
      "code": "string",
      "details": {}
    }
  ]
}

Add a carrier connection

/v1/connections

Request​

Body

Responses​

Request

Responses