SimplyPrint icon

SimplyPrint

Monitor and control SimplyPrint print farms - printers, queue, files, filament

Actions32

Print Job → Create

AI-generated

Summary

Create a new print job to start printing a file on one or more specified printers using the SimplyPrint API.

Inputs

  • Authentication — Method for authenticating to SimplyPrint: OAuth2 or API Key.
  • Printer IDs (required) — Comma-separated list of target printer IDs to send the print job to.
  • File Source (required) — Select whether the gcode file comes from an uploaded user file or a queue item.
  • File (required) — Specify the uploaded user file to print if File Source is 'User File'. Can be selected from a list or provided by ID.
  • Queue Item (required) — Specify the queue item to print if File Source is 'Queue Item'. Can be selected from a list or provided by ID.
  • Shared Custom Fields — Custom field values applied to every printer involved in the print job, specified as multiple key-value pairs. Each requires a Custom Field ID UUID, a type (boolean, date, json, number, text), and a value.
  • Individual Custom Fields (JSON) — JSON array specifying per-printer custom field overrides, where each entry identifies a printer ID and an array of custom field submissions.
  • Start Options (JSON) — Optional JSON object with start options parameters passed directly to SimplyPrint (e.g. nozzle size, filament material, print speed).
  • MMS Map (JSON) — Optional JSON object for multi-material slot mapping passed through to SimplyPrint's backend.

Output shape

a JSON object representing the created print job confirmation or details returned from SimplyPrint

The operation returns a single object (not paginated). Throws errors if required inputs are missing or invalid. The API response typically confirms the creation of the print job initiated across the specified printers.

Examples

Example 1: Create print job for two printers from an uploaded user file with custom fields and start options

Provide printer IDs as '42,77', select 'User File' as the file source, choose a file from the list or by ID, include optional shared custom fields and start options JSON, then execute the node to start the print job.

Links

Discussion