Get your Carrier Account Details

To use Better Trucks as your preferred carrier, you must use your own account and share your account details with Shippo. This is useful if you have negotiated your own shipping discounts with your preferred carrier. You can still use all the supported Shippo features.

Use your own carrier account

Follow this guide to add your Better Trucks account to Shippo. After adding your account, Shippo can use your account details for generating shipping rates and creating labels. This step requires you to have your Better Trucks account id and password.

info

Don't already have a Better Trucks account? Contact our support team to help you get signed up.

This step should only be completed once. When you have created your carrier account, you can use the carrier object_id to reference your carrier.

HTTP Method

POST

URL

Copy

Copied

https://api.goshippo.com/carrier_accounts/

Request Payload

Parameter	Description
carrier*	`better_trucks`
account_id*	A unique identifier for the account which cannot be changed later. Used only for internal purposes
parameters*	parameters is an array of additional parameters for the account, such as password or token. Check Better Trucks parameters for more details
active	Set to `true` to enable account. Set to `false` to disable account.
test	Set to `true` if you want to set the account in test mode. Using test mode you can generate test labels without incurring a charge

Copy

Copied

Note: Parameters with an * are mandatory

Better Trucks Account Parameters

Parameter	Description
api_key*	Key to access the API. A string value Better Trucks assigns to each client.
account_id*	Key to access the API. A string value Better Trucks assigns to each client.

Response Code

201

Example

Request Sample

Copy

Copied

curl --location --request POST 'https://api.goshippo.com/carrier_accounts/' \
--header 'Authorization: ShippoToken shippo_live_******' \
--header 'Content-Type: application/json' \
--data-raw '{
   "carrier": "better_trucks",
   "account_id": "Better_truck_account",
   "parameters": {
       "api_key": "unique_api_key_should_be_here",
       "account_id": "unique_account_id_should_be_here"
   },
   "test": true,
   "active": true
}'

Response Sample

Copy

Copied

 {
   "carrier": "better_trucks",
   "object_id": "a00414e75df144b596673979108bbab5",
   "object_owner": "nataliya_eng@shippo.com",
   "account_id": "Better_truck_account",
   "parameters": {
       "api_key": "******",
       "account_id": "UNIQUE_ACCOUNT_ID_HERE"
   },
   "test": false,
   "active": true,
   "is_shippo_account": false,
   "metadata": "",
   "carrier_name": "BetterTrucks",
   "carrier_images": {
       "200": "https://dev-qa-static-shippodev-com.s3.amazonaws.com/providers/200/bettertrucks.png",
       "75": "https://dev-qa-static-shippodev-com.s3.amazonaws.com/providers/75/bettertrucks.png"
   }
}

Once you have retrieved the object_id for your carrier, proceed to Step 2: Create shipment.