LetterXpress
CommunicationSubmit a PDF to LetterXpress and it prints, folds, franks, and posts the physical letter, with electronic delivery and billing also covered. Agents send legally required paper mail without a mailroom.
What This Integration Enables
LetterXpress takes a finished PDF and turns it into a physical letter: printed, folded, franked and handed to the post. FlowRunner agents drive that end to end, and also drive SMART@MAIL, the electronic delivery path, plus the account side that finance actually needs afterwards, including balance, transactions, invoices and the outgoing mail journal as a downloadable CSV.
The design detail that shapes every flow built on this connector is that there is no recipient parameter. The address is read from the document itself, following the LetterXpress layout rules. Your document generator is therefore also your addressing system, and a template that drifts by a few millimetres or fills the wrong merge value produces a letter that is franked and posted to whoever the window happens to show. LetterXpress allows changes for 15 minutes after submission, but never to the PDF, only to shipping settings, dispatch date and the note. That is not a safety net for the thing most likely to be wrong, which is why FlowRunner puts a person on the rendered page before Send Letter rather than after it.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Payment reminders from the ERP
A finance flow watches for invoices that have passed their second reminder date in NetSuite or Acumatica. For each one it renders the reminder letter to A4 portrait, calls Get Price Quote to price the dispatch, and checks Get Balance so the batch does not stall halfway. The rendered first page and the quoted cost go to credit control. Once approved, the agent calls Send Letter per invoice, writes the returned job ID onto the ERP record, and polls Get Letter Job until the status reads done. For the accounts where registered mail is warranted, the job carries the tracking code back and it lands on the same record.
Electronic delivery first, paper as the fallback
Not every recipient needs paper. The agent calls Send Email Letter for SMART@MAIL delivery and polls Get Email Letter Job. If delivery does not succeed, the response carries the failure reason, and the flow has a real choice to make: correct the recipient with Update Email Letter Job, which works right up until delivery, or fall back to Send Letter and post the same document. The electronic path is correctable and the paper path is not, so the flow tries the correctable one first and escalates the fallback to a person.
Monthly reconciliation of postal spend
At month end the agent calls List Transactions to pull per-letter charges, List Invoices to find the invoices raised, and Download Invoice to save each PDF into FlowRunner file storage. Download Outgoing Mail Journal exports the mail book for the period as a CSV, narrowed to one dispatch channel or searched by recipient address. The agent reconciles the journal against the ERP records and posts a summary. Where a letter appears in the journal with no matching ERP record, it does not guess: it asks the controller which side is wrong before anything is written back.
Human-in-Loop Highlight
The gate is on the addressed page, not on the message. Because LetterXpress reads the recipient off the PDF, a merge failure in the address block is not a cosmetic problem, it is a misdelivery, and it is one that the 15-minute correction window cannot fix because Update Letter Job is explicitly not allowed to replace the document. So before Send Letter, the agent posts the rendered first page as an image alongside a short line: "Reminder 2 for invoice 20894, Muster GmbH, 2 pages, national dispatch, 0.95 EUR. The address block reads what you see here. Send, or hold?" The approver is looking at the exact thing the franking machine will see. If it is wrong, it is wrong while it is still a file. This is human-in-the-loop applied where the irreversibility actually is, which on this connector is the moment the document leaves rather than the moment the text was written.
Agent Capabilities
16 actionsLetters
6- Send Letter Submits a PDF to be printed and posted, returning the new job ID. Sending is asynchronous, so flows poll Get Letter Job to follow production and delivery. The PDF must be A4 portrait and under 50MB, and the recipient address is read from the document itself. In test mode the job lands in the basket instead of being dispatched.
- Get Letter Job Retrieves a single job with its production status, page count, cost and per-recipient items, including the tracking code and tracking status for registered mail. Used to poll a submitted job until its status reads done.
- List Letter Jobs Lists jobs newest first, optionally narrowed to one production state. Each entry carries its recipient items, cost and tracking information, which makes this the reconciliation view for a batch.
- Update Letter Job Changes the dispatch options of a job that has not yet gone into production. LetterXpress allows changes only within 15 minutes of submission, and the PDF itself can never be replaced, only shipping settings, registered mail, dispatch date and the note.
- Delete Letter Job Cancels a job before it enters production, within the same 15 minute window. A job that has reached the done state can no longer be removed.
- Get Price Quote Calculates what a letter would cost before it is sent, given page count and dispatch options. Only national and international shipping can be priced, and registered mail can be priced nationally, so this is a budget check rather than a universal quote.
Electronic Delivery
5- Send Email Letter Submits a PDF for SMART@MAIL electronic delivery, returning the job ID. Supply a recipient address for a single document, or omit it and rely on a white code printed inside the PDF, which also allows serial processing into many individual letters. Mail Plus additionally produces a physical letter, so the response may include a print job.
- Get Email Letter Job Retrieves a job with its delivery status, cost, subject and body, plus the failure reason when delivery did not succeed. Mail Plus and Mail Secure jobs also return the physical print job produced alongside them.
- List Email Letter Jobs Lists electronic delivery jobs newest first, optionally narrowed to one delivery state. Mail Plus entries carry the physical print job produced with them.
- Update Email Letter Job Corrects the recipient address on a job that has not yet been delivered. This is the one address correction the connector offers, and it exists only on the electronic path.
- Delete Email Letter Job Cancels an electronic delivery job before it is sent. Once delivered it can no longer be withdrawn.
Account and Billing
5- Get Balance Retrieves the remaining credit on the account with its currency. Used as a guard step before a bulk send, or to raise a low balance alert.
- List Transactions Lists account movements newest first, covering deposits, payouts and per-letter charges with amount, currency and description. Filter to one kind of movement to reconcile spend separately from top-ups.
- List Invoices Lists the invoices raised on the account with net amount, VAT and invoice date. Paired with Download Invoice to fetch the PDF for a chosen entry.
- Download Invoice Fetches a single invoice, decodes the PDF LetterXpress returns, and saves it to FlowRunner file storage, returning a URL for later steps. The amount, VAT and date come back alongside the file.
- Download Outgoing Mail Journal Exports the outgoing mail book for a date range as a CSV and saves it to FlowRunner file storage. Narrow the export to one dispatch channel, or search by letter number or recipient address, to produce a reconciliation or audit report.
Frequently Asked Questions
What can FlowRunner do with LetterXpress?
FlowRunner agents can run Send Letter, Get Letter Job, and List Letter Jobs in LetterXpress, plus 13 more actions.
Does connecting LetterXpress to FlowRunner require OAuth?
No. LetterXpress connects to FlowRunner with basic authentication (a username and password), no OAuth flow required.
Can LetterXpress trigger a FlowRunner workflow automatically?
LetterXpress doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with LetterXpress
$100 in credits. No card required. Connect in minutes.