BTC Postage Link Builder

This tool allows you to generate a URL that prefills all or part of a new label form. The simplest way to generate a prefill URL is to use our prefill link builder tool. Developers who want to generate BTC Postage URLs within their applications can refer to the following available prefill options.

Prefill links should use this base URL (https://btcpostage.com/?) and all params should be appended to the URL. All parameters are optional and are used to prefill a user-editable label form. No API key is required.

Link Parameters

Name Description
service The carrier that will deliver the package. Click here to see a list of valid carriers.
package_type Determines if the package will be flat rate or custom. Click here to see a list of valid package types.
weight_lbs Weight of the package in pounds. This value is added to weight_oz to obtain the final weight. Ignored unless the package type is custom.
weight_oz Weight of the package in ounces. This value is added to weight_lbs to obtain the final weight. Ignored unless the package type is custom.
height Height of the package in inches. Ignored unless the package type is custom.
width Width of the package in inches. Ignored unless the package type is custom.
depth Length/depth of the package in inches. Ignored unless the package type is custom.
from_name Name of the sender.
from_street Street component of the sender address.
from_apt Apartment or second street line of the sender address.
from_city City of the sender address.
from_state State of the sender address.
from_zip Zip code of the sender address.
from_country Country of the sender address.
from_phone Phone number of the sender.
to_name Name of the receiver.
to_street Street component of the receiver address.
to_apt Apartment or second street line of the receiver address.
to_city City of the receiver address.
to_state State of the receiver address.
to_zip Zip code of the receiver address.
to_country Country of the receiver address.
to_phone Phone number of the receiver.
redirct URL you would like the user to return to after purchase.

Carriers

Name Description
usps United States Postal Service
fedex Federal Express
ups United Parcel Service
dhl DHL International
canadapost Canada Post

Carrier Service Options

Name Description
SMART_POST FedEx SmartPost
FEDEX_INTERNATIONAL_CONNECT_PLUS FedEx International Connect Plus
ups_standard UPS® Standard
ups_worldwide_express UPS Worldwide Express®
ups_express_plus UPS Worldwide Express Plus®
ups_worldwide_expedited UPS Worldwide Expedited®
ups_worldwide_saver UPS Worldwide Saver®
ups_next_day_air UPS Next Day Air®
ups_second_day_air UPS 2nd Day Air®
ups_ground UPS® Ground
ups_next_day_air_early_am UPS Next Day Air® Early
ups_next_day_air_saver UPS Next Day Air Saver®
ups_second_day_air_am UPS 2nd Day Air A.M.®
ups_three_day_select UPS 3 Day Select®

Package Types

Name Carrier Description
custom Any Custom size box or package
Card usps Must be a flat surface with a maximum weight of 3.5oz. Minimum dimensions: 3 1/2" x 5 1/2'. Maximum dimensions: 4 1/4" x 6".
Flat usps Flat surface with a maximum weight of 13oz. Minimum dimensions: 6 1/8" x 11 1/2". Maximum Dimensions: 12" x 15".
Parcel usps Maximum size is 108" in combined length and girth (distance around the thickest part). Contents must weigh less than 70 lbs (15.99 oz for First Class).
LargeParcel usps Maximum size is 130" in combined length and girth (distance around the thickest part). Contents must weigh less than 70 lbs.
IrregularParcel usps This package type covers: rolls and tubes up to 26" long, and articles that are not letter-sized, flat-sized, or machinable parcels. Contents must weigh less than 70 lbs.
FlatRateEnvelope usps Uses pre-purchased 12-1/2" x 9-1/2" package. Contents must weigh less than 70 lbs (4 lbs for international).
FlatRateLegalEnvelope usps Uses pre-purchased 15" x 9 1/2" package. Contents must weigh less than 70 lbs (4 lbs for international).
FlatRatePaddedEnvelope usps Uses pre-purchased 12 1/2" x 9-1/2" package. Contents must weigh less than 70 lbs (4 lbs for international).
FlatRateGiftCardEnvelope usps Uses pre-purchased 10" x 7" package. Contents must weigh less than 70 lbs (4 lbs for international).
FlatRateWindowEnvelope usps Uses pre-purchased 10" x 5" package. Contents must weigh less than 70 lbs (4 lbs for international).
FlatRateCardboardEnvelope usps Uses pre-purchased 12 1/2" x 9-1/2" package. Contents must weigh less than 70 lbs (4 lbs for international).
SmallFlatRateEnvelope usps Uses pre-purchased 12 1/2" x 9-1/2" package. Contents must weigh less than 70 lbs (4 lbs for international).
SmallFlatRateBox usps Uses pre-purchased 8 5/8" x 5 3/8" x 1 5/8" package. Contents must weigh less than 70 lbs.
MediumFlatRateBox usps Uses pre-purchased 11" x 8 1/2" x 5 1/2" package. Contents must weigh less than 70 lbs.
LargeFlatRateBox usps Uses pre-purchased 12" x 12" x 5 1/2" package. Contents must weigh less than 70 lbs.
RegionalRateBoxA usps Uses pre-purchased 10 1/8" x 7 1/8" x 5" or 16 1/6" x 11 1/6" x 2 1/2" package. Contents must weigh less than 15 lbs.
RegionalRateBoxB usps Uses pre-purchased 12 1/4" x 10 1/2" x 5 1/2" or 16 1/4" x 14 1/2" x 3" package. Contents must weigh less than 20 lbs.
LargeFlatRateBoardGameBox usps Uses pre-purchased package with inside dimensions of 23 11/16" x 11 3/4" x 3" and outside dimensions of 24 1/16" x 11 7/8" x 3 1/8". Contents must weigh less than 70 lbs.
custom fedex Minumum size 6" x 4" x 1". Minimum weight 16 oz.