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. |