Adding letterheads and attaching extra documents

Reusable backgrounds

Backgrounds let you apply a consistent letterhead, logo, or footer across multiple letters without redesigning each one. Upload a PDF or Word file as a background from the Dashboard or via the API, then reference it by ID in a print job.

import fs from 'fs'

const background = await ip.backgrounds.create({
  file: fs.createReadStream('path/to/my/background.pdf'),
  name: 'Company Letterhead'
})

const printJob = await ip.prints.create({
  background: {
    first_page: background.id,
    other_pages: background.id
  },
  // ...other print job properties
})

A print job can use two distinct backgrounds: background.first_page applies only to the first page (typically your letterhead), and background.other_pages applies to every other page (typically a continuation design or footer).

Tip: when sending plain text or HTML content, applying a background makes the letter look far more professional and polished than a plain page.

Attaching extra documents

Attach terms and conditions, forms, brochures, flyers, or other supplementary materials to a letter as extra PDF or Word documents.

• Provide each document under extra_documents, either as a file upload or base64-encoded data.
• Extra documents print in the same order you list them in.
• Set apply_background: true on an individual document if you want your reusable background applied to it too.
• Extra documents are only available on letters — postcards are sent as a single piece of card.

See the full parameter reference for reusable backgrounds and attaching extra documents in the developer docs.