LetterStream API Information
Getting Started
Tech savvy customers can push documents for printing and mailing directly to our servers, via our API. This is a great option for some companies, but might not be the best option for everyone.
Please be sure to read the information contained in this article in order to determine wether or not our API is a good fit for you.
In This Article
- General Information
- Supported Mail Types
- Unsupported Mail Types
- Qualification Process
- Setup and Activation
- Reviews
General Information
Our API system only works with PDF's, so your program should be able to generate PDF documents.
If you are using our API for a service that you provide to your customers, you will need to continue providing customer support for them (as we don't "exist" in that case).
Your mailings can be submitted to us, but they won't be processed until they are paid for. Pre-funding your account is the best way to ensure a smooth mailing process.
Either you are a developer, you have a developer in-house, or you are okay with contracting out a developer to execute the code required on your end to tie into our website.
Supported Mail Types
1. First Class Letters - mailed in standard #10 double-windowed secure envelope
2. First Class Letters "HSE" - mailed in standard #10 double-windowed secure envelope with “Homeowner Statement Enclosed” verbiage printed in black ink on the front of the envelopes
3. Certified with Electronic Return Receipt - mailed in standard #10 tri-windowed certified mail envelopes, (includes a third window for certified mail barcode and USPS tracking number)
4. Certified without Electronic Return Receipt - mailed in standard #10 tri-windowed certified mail envelopes, (includes a third window for certified mail barcode and USPS tracking number). Signatures will not be provided by the USPS upon successful delivery
5. Postcards - 5.5” x 4.25” cardstock, addresses on one side, image or pdf imposition included on reverse side
6. Flats - 10x13 windowed envelope capable of holding 75 sheets of 8.5x11 20lb. paper, includes coversheet by default
Unsupported mail types
FedEx is a mail type that's currently only available for pre-approved businesses and is not supported through the API at this time.
Qualification Process
We like to know who's utilizing our API and to help make sure it's the right fit, therefore the API isn't available by default within your account. We spend a lot of time making sure our website is powerful and efficient, and in most cases it's better to send mail through the dashboard directly rather than the API. We also don't integrate the API on your behalf, but rather that needs to be accomplished by a developer on your end. If you'd like to pursue the possibility of utilizing our API, send us an email along with the following pieces of information and we'd be happy to assist further:
- Company Name and Website
- Name of existing API software, or company or business you plan to integrate our API with
- Primary interest in the API
- Target date for sending your first real mailings through it
- Number of pieces of mail you anticipate sending each month
Setup and Activation
Once you've been approved and the API has been activated in your account by us, your team can begin the setup process. All of the instructions and documentation needed can be found on the API Information page, under the My Account tab (the API Information option won't exist if the API has not yet been turned on for your account)