Test mode, confirming, and submitting a print job

Test mode

Test mode print jobs are not charged for and are not actually sent out. Set the testmode parameter to true to create a print job in test mode.

Note: Test mode print jobs don't appear in the Dashboard by default — switch to test mode with the top-right mode selector to see them there, or pass testmode: true when listing jobs via the API.

Confirming a print job

Print jobs can be confirmed at the time of creation, or up to 30 days later, by setting the confirmed parameter to true. Which you choose depends on your workflow:

• Automated workflows generally confirm the print job at the time of creation.
• Manual workflows generally create the print job, make changes while reviewing the preview, then confirm once satisfied.

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: true,
  testmode: true // Set to false once you're ready to send for real — your account will be charged.
})

To confirm a print job after creating it, update it with confirmed: true rather than creating a new one.

Full parameter details are in the developer docs.