Overview
Connect SimplyPrint with Flows360
3D printer fleet management: monitor printers, manage the print queue, track filament, and automate print jobs.
Use the SimplyPrint connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 63 actions and 62 triggers.
Available actions
- List Printers
- Get Farm Overview
- Get Printer
- Pause Print
- Resume Print
- Cancel Print
- Cancel Pending Print
- Clear Printer Bed
- Plus 55 additional declared actions.
Available triggers
- Print Started
- Print Paused
- Print Resumed
- Print Cancelled
- Print Finished
- Print Failed
- Plus 56 additional declared triggers.
The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.
Technical guide
Technical reference
Package identity
- Connector: SimplyPrint
- Package:
@activepieces/piece-simplyprint@0.6.6 - Exact artifact digest:
sha256:f2e20b4fc7960db58e432a2bf09032742449ab9ca86c4f670d262c608040afbd - Runtime: Activepieces-compatible deterministic worker
- Source: the exact reviewed Activepieces source
Authentication
OAUTH2. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.
Action contracts
- List Printers (
list_printers), List every printer in your SimplyPrint account with current status. Classification: read. - Get Farm Overview (
get_farm_overview), One-shot fleet summary: total printer count plus per-bucket lists (online/offline, printing/paused, awaiting bed clear, in maintenance, requires-attention, AI failure detections, …). Use this instead of paginating "List Printers" when you just need counts and the printers in each state. Classification: read. - Get Printer (
get_printer), Get detailed information about a specific printer. Classification: read. - Pause Print (
pause_print), Pause the current print on a printer. Classification: read. - Resume Print (
resume_print), Resume a paused print on a printer. Classification: read. - Cancel Print (
cancel_print), Cancel the current print on a printer. This is destructive, the job cannot be resumed. Classification: read. - Cancel Pending Print (
cancel_pending_print), Cancel a print that's queued/staged on a printer but hasn't started yet (status = print_pending). Distinct from "Cancel Print", which targets the active print. Classification: read. - Clear Printer Bed (
clear_printer_bed), Mark a printer's bed as cleared after a print finishes. Bread-and-butter step in AutoPrint flows, pair with a "print done" trigger to automate bed clearing. Classification: read. - Skip Print Objects (
skip_print_objects), Skip one or more individual model objects on the current print (printer must be in PRINTING / PAUSED / PAUSING / CANCELLING / RESUMING state). Single printer per call. Classification: read. - Set Printer Out of Order (
set_printer_out_of_order), Mark one or more printers as out-of-order (or clear that flag). Requires the Out-of-Order feature on the account. Classification: read. - Send G-code (
send_gcode), Send raw G-code commands to an operational printer (requires Print Farm plan). Classification: read. - Start Print (
start_print), Start a print job on one or more printers from an existing file, queue item, or print-job reference. Classification: read. - Get Printer Notifications (
get_printer_notifications), Fetch the open notifications/events on one or more printers. Pairs well with therequires_attentionbucket from "Get Farm Overview". Classification: read. - Resolve Printer Notification (
resolve_printer_notification), Mark a printer notification as resolved (or dismissed). For notifications with multiple actions, passactionto pick one orforce: trueto resolve without choosing. Classification: read. - List Queue Items (
list_queue), List items in the print queue, optionally filtered to a single queue group. Classification: read. - Get Queue Item (
get_queue_item), Fetch a single queue item by numeric ID, returns the formatted record (file metadata, assignments, custom fields, …). Classification: read. - Get Next Queue Items (
get_next_queue_items), Resolve the next-up queue items for one or more printers using the company's match criteria (with deduplication so the same item is never assigned twice). Returns the matched queue object with item references per printer. Classification: read. - Preview Next Queue Items per Printer (
get_next_queue_items_for_printers), Read-only preview of the next-up queue item for each given printer (no dedup, no offline checks). For each printer, returns either the matched queue item or the issues blocking a match. Different from "Get Next Queue Items": that one dedupes for actual scheduling, this one shows what each printer would pick. Classification: read. - List Queue Groups (
list_queue_groups), List every queue group on your account. Classification: read. - Save Queue Group (
save_queue_group), Create or update a queue group. Pass an existing group ID to edit it; omit it to create a new one. Requires the Queue Groups feature on the account. Classification: read. - Delete Queue Group (
delete_queue_group), Delete a queue group. Items in the group are moved to "Move to" group, or to the first remaining group if not specified, or set to ungrouped if it was the last group. Classification: read. - Add File to Queue (
add_to_queue), Add an existing file (API-uploaded or user-file) to the print queue. For uploading a new file at the same time, use "Upload File & Add to Queue". Classification: read. - Update Queue Item (
update_queue_item), Update a queue item (amount, note, etc.). Classification: read. - Set Queue Item Printer Assignments (
set_queue_item_printers), Assign one or more queue items to specific printers, printer models, and/or printer groups. Replaces the current assignments on each item. Classification: read. - Move Queue Item (
move_queue_item), Move a queue item to a different queue group. Classification: read. - Remove Queue Item (
remove_from_queue), Remove an item from the print queue. Destructive, the item is gone. Classification: read. - Revive Queue Item (
revive_queue_item), Bring a completed (done) queue item back to the active queue. Classification: read. - Empty Queue (
empty_queue), Delete every item from the print queue (optionally filtered to a group or done-only). Destructive. Classification: read. - List Pending Queue Items (
list_pending_queue_items), List queue items awaiting approval, denied, or sent back for revision. Classification: read. - Approve Queue Item (
approve_queue_item), Approve one or more pending queue items. Classification: read. - Deny Queue Item (
deny_queue_item), Deny a pending queue item (remove or send back for revision). Classification: read. - List Files (
list_files), List files in your SimplyPrint account, optionally within a folder and/or filtered by a search term. Classification: read. - Upload File (
upload_file), Upload a file or HTTPS URL to SimplyPrint. URL uploads stream with ~95 MiB peak RAM; File uploads are buffered by AP. Files over 95 MiB are chunked automatically. Returns the API file id, pass it to "Add File to Queue" or "Start Print" later. Classification: read. - Upload File & Add to Queue (
upload_and_queue), Upload a local file or HTTPS URL to SimplyPrint and add it to the print queue in one step. URL uploads stream with ~95 MiB peak RAM; File uploads are buffered by AP. Files over 95 MiB are chunked automatically. For starting the print afterwards, chain a "Start Print" action. Classification: read. - Upload File to Folder (
upload_to_folder), Upload a file (or HTTPS URL) and save it to your SimplyPrint user file system, optionally inside a specific folder. URL uploads stream with ~95 MiB peak RAM; File uploads are buffered by AP. Files over 95 MiB are chunked automatically. Classification: read. - Move File (
move_file), Move one or more user files to a different folder. Classification: read. - Create or Update Folder (
create_folder), Create a new folder in the user file system, or update an existing one (pass the folder ID to edit). Optionally an "organization" / shared folder with per-rank view/upload/modify permissions. Classification: read. - Delete Files (
delete_files), Permanently delete one or more user files by UID. Returns a partial-success report, files the caller can't modify are reported inerrorswhile accessible files are deleted. Classification: read. - Delete Folders (
delete_folders), Delete one or more folders (and everything in them). All-or-nothing: if any folder isn't modifiable by the caller, the whole call fails. Classification: read. - Update File (
update_file), Rename a user file and / or update its compatible-printer assignments. (Thumbnail upload is not exposed here, multipart isn't supported on this endpoint over OAuth via the AP HTTP client.) Classification: read. - Download File (
download_file), Download a file from SimplyPrint by user-file UID, queue-item ID, or print-job UID. Returns the file as an Activepieces file reference plus content-type / size metadata. Classification: read. - List Filaments (
list_filaments), List filament spools in your SimplyPrint account, with optional filters and sort. Classification: read. - Get Filament (
get_filament), Get detailed information about a specific filament spool by numeric ID or 4-character short ID (uid). Classification: read. - Create Filament (
create_filament), Add a new filament spool to your inventory. Use the free-text brand/color fields for ad-hoc spools or the catalog ids for known SKUs. Classification: read. - Adjust Filament Weight (
adjust_filament_weight), Update the remaining filament on a spool. Provide ONE of "grams remaining" / "percent remaining" / "weighed gross", the other two derive from it. Classification: read. - Mark Filament as Dried (
mark_filament_dried), Record that one or more spools were just dried. Updates each spool's last-dried timestamp. Classification: read. - Get Filament History (
get_filament_history), Paginated usage history for a specific spool, print jobs, weight adjustments, drying cycles, etc. Classification: read. - Assign Filament to Printer (
assign_filament), Assign a filament spool to a printer at a specific nozzle + extruder slot. Defaults to nozzle 0 / extruder 0 (single-nozzle single-extruder printers); set the indices for multi-nozzle (e.g. IDEX, toolchanger) or multi-material (MMS, MMU) printers. Classification: read. - Unassign Filament (
unassign_filament), Detach a specific filament spool from whichever printer it is currently assigned to. Classification: read. - List Print History (
list_print_history), List completed print jobs, optionally filtered to a single printer. Classification: read. - Get Print Job (
get_print_job), Fetch a single print job's full record by its UID, timeline, pictures, spools used, gcode analysis, filament data, cost, AI inference, custom fields, etc. Classification: read. - Archive Print Jobs (
archive_print_jobs), Archive one or more completed print jobs (removes them from the active history view). Classification: read. - Unarchive Print Jobs (
unarchive_print_jobs), Restore one or more archived print jobs to the active history view. Classification: read. - List Tags (
list_tags), List all custom tags configured on your account. Classification: read. - Create or Update Tag (
create_tag), Create a new custom tag, or rename / re-style an existing one (pass the tag ID to edit). Classification: read. - Assign Custom Tag (
assign_tag), Attach an existing custom tag to a printer, printer group, file, or queue item. Use "Create or Update Tag" first to get the tag ID. Classification: read. - Detach Tag (
detach_tag), Remove a single custom tag from one printer, printer group, file, or queue item. Classification: read. - Delete Tag (
delete_tag), Delete a custom tag from the account. The tag is removed from every printer/file/queue item it was attached to. Classification: read. - Get Current User (
get_current_user), Return information about the SimplyPrint account connected to this flow. Classification: read. - List Custom Fields (
list_custom_fields), List all custom field definitions on your account. Classification: read. - Set Custom Field Values (
set_custom_field_values), Set custom field values on one or more entities (queue items, files, printers, etc.). Classification: read. - Get Account Statistics (
get_statistics), Fetch high-level printing statistics (total prints, materials used, hours, etc.). Classification: read. - Custom API Call (
custom_api_call), Call any SimplyPrint REST endpoint the piece does not wrap directly. Useful for admin / partner / school-dashboard endpoints and anything else behind OAuth scopes. Classification: read.
Trigger contracts
- Print Started, webhook.
- Print Paused, webhook.
- Print Resumed, webhook.
- Print Cancelled, webhook.
- Print Finished, webhook.
- Print Failed, webhook.
- Bed Cleared, webhook.
- Objects Skipped, webhook.
- Printer AutoPrint State Changed, webhook.
- Printer Nozzle Size Changed, webhook.
- Printer Material Changed, webhook.
- Printer Tag Assigned, webhook.
- Printer Tag Removed, webhook.
- Printer Out-of-Order State Changed, webhook.
- AI State Changed, webhook.
- AI Failure Detected, webhook.
- AI Failure Marked False Positive, webhook.
- AutoPrint Max Cycles Reached, webhook.
- Company AutoPrint State Changed, webhook.
- Queue Item Added, webhook.
- Queue Item Deleted, webhook.
- Queue Emptied, webhook.
- Queue Item Moved, webhook.
- Queue Item Revived, webhook.
- Queue Item Pending Approval, webhook.
- Queue Item Approved, webhook.
- Queue Item Denied, webhook.
- Filament Created, webhook.
- Filament Updated, webhook.
- Filament Deleted, webhook.
- Filament Assigned to Printer, webhook.
- Filament Unassigned from Printer, webhook.
- Organization User Signed Up, webhook.
- Organization User Pending Approval, webhook.
- Balance Charged, webhook.
- Balance Refunded, webhook.
- Balance Topped Up, webhook.
- Balance Adjusted, webhook.
- Quota Request Submitted, webhook.
- Quota Request Resolved, webhook.
- Quota Adjusted, webhook.
- Quota Reset, webhook.
- Maintenance Job Created, webhook.
- Maintenance Job Started, webhook.
- Maintenance Job Completed, webhook.
- Maintenance Job Cancelled, webhook.
- Maintenance Job Overdue, webhook.
- Maintenance Job Reopened, webhook.
- Maintenance Job Updated, webhook.
- Maintenance Job Deleted, webhook.
- Maintenance Problem Reported, webhook.
- Maintenance Problem Resolved, webhook.
- Maintenance Task Completed, webhook.
- Maintenance Task Skipped, webhook.
- Maintenance Schedule Created, webhook.
- Maintenance Schedule Updated, webhook.
- Maintenance Schedule Deleted, webhook.
- Spare Part Created, webhook.
- Spare Part Updated, webhook.
- Spare Part Deleted, webhook.
- Spare Part Stock Adjusted, webhook.
- Spare Part Low Stock, webhook.
Verification
Runtime execution evidence is managed separately from package metadata.
Capability summary
Authentication
Authentication method: OAuth 2.0
Required scopes
user.readprinters.readprinters.writeprinters.actionsqueue.readqueue.writefiles.readfiles.writefiles.temp_uploadspools.readspools.writeprint_history.readprint_history.writestatistics.readcustom_fields.readcustom_fields.writetags.readtags.writewebhooks.readwebhooks.write Authentication profiles
connection · oauth2
OAuth scopes: user.read, printers.read, printers.write, printers.actions, queue.read, queue.write, files.read, files.write, files.temp_upload, spools.read, spools.write, print_history.read, print_history.write, statistics.read, custom_fields.read, custom_fields.write, tags.read, tags.write, webhooks.read, webhooks.write
Triggers
Print Started · Webhook
Fires when a print job starts on any printer.
Print Paused · Webhook
Fires when a print is paused (manually or by the AI failure watcher).
Print Resumed · Webhook
Fires when a paused print is resumed.
Print Cancelled · Webhook
Fires when a print is cancelled before finishing.
Print Finished · Webhook
Fires when a print completes successfully.
Print Failed · Webhook
Fires when a print terminates with a failure.
Bed Cleared · Webhook
Fires when a printer's bed is reported cleared (ready for the next job).
Objects Skipped · Webhook
Fires when one or more objects in a multi-object print are skipped.
Printer AutoPrint State Changed · Webhook
Fires when a printer's AutoPrint enabled/disabled state changes.
Printer Nozzle Size Changed · Webhook
Fires when a printer's active nozzle diameter is updated.
Printer Material Changed · Webhook
Fires when a printer's loaded material is updated.
Printer Tag Assigned · Webhook
Fires when a custom tag is attached to a printer.
Printer Tag Removed · Webhook
Fires when a custom tag is detached from a printer.
Printer Out-of-Order State Changed · Webhook
Fires when a printer is marked out of order (or back in service).
AI State Changed · Webhook
Fires when a printer's AI failure detection is enabled, disabled, or reconfigured.
AI Failure Detected · Webhook
Fires when the AI failure detector flags a potential print failure.
AI Failure Marked False Positive · Webhook
Fires when an AI failure alert is dismissed as a false positive.
AutoPrint Max Cycles Reached · Webhook
Fires when a printer hits its configured AutoPrint cycle limit.
Company AutoPrint State Changed · Webhook
Fires when the account-wide AutoPrint master switch is toggled.
Queue Item Added · Webhook
Fires when a file is added to the print queue.
Queue Item Deleted · Webhook
Fires when a queue item is removed from the queue.
Queue Emptied · Webhook
Fires when a queue group (or the whole queue) is emptied.
Queue Item Moved · Webhook
Fires when a queue item is moved to another group or reordered.
Queue Item Revived · Webhook
Fires when a completed queue item is sent back into the active queue.
Queue Item Pending Approval · Webhook
Fires when a queue item is submitted and awaits approval.
Queue Item Approved · Webhook
Fires when a pending queue item is approved.
Queue Item Denied · Webhook
Fires when a pending queue item is denied.
Filament Created · Webhook
Fires when a filament spool is added to the account.
Filament Updated · Webhook
Fires when a filament spool's metadata is updated.
Filament Deleted · Webhook
Fires when a filament spool is deleted.
Filament Assigned to Printer · Webhook
Fires when a filament spool is assigned to a printer.
Filament Unassigned from Printer · Webhook
Fires when a filament spool is removed from a printer.
Organization User Signed Up · Webhook
Fires when a new user signs up for the organization.
Organization User Pending Approval · Webhook
Fires when a new organization user is awaiting admin approval.
Balance Charged · Webhook
Fires when a user balance is charged (debited).
Balance Refunded · Webhook
Fires when a previous charge is refunded.
Balance Topped Up · Webhook
Fires when a user balance is topped up (credited).
Balance Adjusted · Webhook
Fires when a balance is adjusted by an administrator.
Quota Request Submitted · Webhook
Fires when a user submits a request for more quota.
Quota Request Resolved · Webhook
Fires when a quota request is approved or denied.
Quota Adjusted · Webhook
Fires when a user's quota is manually adjusted.
Quota Reset · Webhook
Fires when a quota period rolls over and a user's quota is reset.
Maintenance Job Created · Webhook
Fires when a maintenance job is created.
Maintenance Job Started · Webhook
Fires when work begins on a maintenance job.
Maintenance Job Completed · Webhook
Fires when a maintenance job is completed.
Maintenance Job Cancelled · Webhook
Fires when a maintenance job is cancelled before completion.
Maintenance Job Overdue · Webhook
Fires when a scheduled maintenance job passes its due date without being completed.
Maintenance Job Reopened · Webhook
Fires when a completed or cancelled maintenance job is reopened.
Maintenance Job Updated · Webhook
Fires when a maintenance job's metadata is edited.
Maintenance Job Deleted · Webhook
Fires when a maintenance job is deleted.
Maintenance Problem Reported · Webhook
Fires when a user reports a problem on a printer.
Maintenance Problem Resolved · Webhook
Fires when a reported problem is resolved.
Maintenance Task Completed · Webhook
Fires when an individual maintenance task is checked off.
Maintenance Task Skipped · Webhook
Fires when an individual maintenance task is skipped.
Maintenance Schedule Created · Webhook
Fires when a recurring maintenance schedule is created.
Maintenance Schedule Updated · Webhook
Fires when a recurring maintenance schedule is edited.
Maintenance Schedule Deleted · Webhook
Fires when a recurring maintenance schedule is deleted.
Spare Part Created · Webhook
Fires when a spare part is added to inventory.
Spare Part Updated · Webhook
Fires when a spare part's metadata is updated.
Spare Part Deleted · Webhook
Fires when a spare part is removed from inventory.
Spare Part Stock Adjusted · Webhook
Fires when a spare part's stock count is adjusted.
Spare Part Low Stock · Webhook
Fires when a spare part's stock drops below its low-stock threshold.
Setup
Setup
- Add the SimplyPrint connector to the workflow in the target Flows360 Studio instance.
- Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
- Provide the connection fields declared by the pinned package:
- No provider credential fields are declared by the pinned package.
OAuth scopes
user.readprinters.readprinters.writeprinters.actionsqueue.readqueue.writefiles.readfiles.writefiles.temp_uploadspools.readspools.writeprint_history.readprint_history.writestatistics.readcustom_fields.readcustom_fields.writetags.readtags.writewebhooks.readwebhooks.write
- Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
- Test the workflow in the appropriate environment before enabling production scheduling or event delivery.
Limitations
Limitations and operational notes
- This content describes
@activepieces/piece-simplyprint@0.6.6; provider behaviour can change independently and should be revalidated when the provider or connector version changes. - Only the 63 actions and 62 triggers declared by this pinned package are represented here.
- Tenant credentials and connection values are not stored in the public connector record.
- Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
- Runtime execution evidence is managed separately from package metadata.
Troubleshooting
Why canu2019t the connector authenticate?
Check the tenant connection in Studio and confirm every required SimplyPrint connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.
Why is an action or trigger unavailable?
Confirm that the workflow is using @activepieces/piece-simplyprint@0.6.6 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.
What should I check after a provider-side change?
Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.