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
dhl DHL International
canada_post Canada Post

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.
FedExEnvelope fedex Uses pre-purchased package with inside dimensions of 9.5" x 12.5" and holds approximately 60 pages. Contents must weigh no more than 8 oz.
FedExSmallBox fedex Uses pre-purchased 12.25" x 10.9" x 1.5" or 8.75" x 2.63" x 11.25" package. Contents must weigh no more than 20 lbs.
FedExMediumBox fedex Uses pre-purchased 13.25" x 11.5" x 2.38" or 8.75" x 4.38" x 11.25" package. Contents must weigh no more than 20 lbs.
FedExLargeBox fedex Uses pre-purchased 17.88" x 12.38" x 3" or 8.75" x 7.75" x 11.25" package. Contents must weigh no more than 20 lbs.
FedExPak fedex Uses pre-purchased 12" x 15.5" package. Contents must weigh no more than 5.5 lbs.
FedExTube fedex Uses pre-purchased 38" x 6" x 6" x 6" package. Contents must weigh no more than 20 lbs.
FedEx10kgBox fedex Uses pre-purchased 15.81" x 12.94" x 10.19" package. Contents must weigh no more than 22 lbs.
FedEx25kgBox fedex Uses pre-purchased 21.56" x 16.56" x 13.19" package. Contents must weigh no more than 55 lbs.