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