Getting started
Three ways to send your first mailing
Files, text/HTML content, or a dashboard template — pick the sending method that fits how your content is generated, then send your first letter or postcard.
Last reviewed · By Intelliprint Team
There are three ways to get a mailing into Intelliprint: upload a finished file, send text or HTML content directly, or reference a reusable template. Which one fits depends on how your content already exists.
Upload a finished file
If you already have a finished letter or postcard as a PDF, Word, RTF, PNG or JPEG file, upload it directly and Intelliprint prints and sends it as-is.
Already has an address on it? If your file already has the recipient's address positioned correctly, you don't need to provide a separate recipients list — Intelliprint reads the address straight from the file.
Send text or HTML content
Prefer to generate the letter body yourself? Pass it as a string in the content field and Intelliprint lays it out on the page for you. This suits personalised, code-generated letters — invoices, statements, one-off notices — where the copy changes every time.
import Intelliprint from 'intelliprint'
const ip = new Intelliprint('your-api-key-here')
const printJob = await ip.prints.create({
type: 'letter',
content: 'Dear Customer,\n\nThank you for your recent order.',
recipients: [{
address: {
name: 'John Doe',
line: '123 Main Street, Anytown, Anyplace',
postcode: 'AB1 2CD',
country: 'GB'
}
}],
confirmed: false
})Tip: Applying a background gives text/HTML content a letterhead or branded footer instead of a plain page — see the letterheads guide below.
Use a dashboard template
For recurring bulk mailings, design a reusable template once in the Intelliprint Dashboard with {variable} placeholders, then reference it by ID and pass a mailing list — each recipient gets their own personalised copy without you writing layout code for every send.
See how to design a template next, or read the full parameter reference in the developer docs.