Integrations Overview

Overview of Maecos integration capabilities — APIs, webhooks, SSO, SAP connectivity, Node-RED flows, and external system connections.

Maecos is designed to fit into your existing enterprise landscape — not replace it. This section documents how to connect Maecos with external systems, automate workflows, and extend the platform to support your specific operational needs.

Integration architecture

Maecos supports several integration patterns, each suited to different use cases:

Pattern	Use case	Direction
Reporting Database	Analytics, BI dashboards, custom reports	Maecos → External
SSO / SAML	Single sign-on via your identity provider	External → Maecos
SAP Integration	PM notifications, work order sync	Bidirectional
Node-RED	Custom automation flows, event-driven logic	Bidirectional
Webhooks	Real-time event notifications to external systems	Maecos → External
REST API	Programmatic access to Maecos data and actions	Bidirectional

Authentication & SSO

Maecos supports enterprise single sign-on through SAML 2.0. This allows your organization to manage Maecos access through your existing identity provider (Azure AD, Okta, Google Workspace, etc.).

Configuration is handled by your Maecos administrator in coordination with our team. Key parameters include the IdP metadata URL, entity ID, and attribute mapping for user roles.

SSO setup requires coordination with your IT team and your Maecos contact. Allow 1–2 business days for configuration and testing.

SAP Integration

Maecos can integrate with SAP PM (Plant Maintenance) to synchronize maintenance notifications and work orders. This integration enables operators to trigger SAP workflows directly from the Maecos interface without switching systems.

For configuration details, see SAP PM Integration.

Node-RED

Maecos includes a built-in Node-RED environment for low-code automation. This enables custom workflows such as:

• Triggering actions in external systems when an issue is created or a checklist is completed

• Enriching Maecos data with information from external sources (ERP, SCADA, historian)

• Building custom notification flows (SMS, Teams, email) based on operational events

• Scheduling automated data exports or report generation

For details, see Node-RED Automation.

Webhooks

Maecos can send real-time event notifications to external HTTP endpoints when key events occur in the platform. Common webhook triggers include issue creation, status changes, checklist completion, and training milestones.

For setup and payload reference, see Webhooks.

REST API

The Maecos REST API provides programmatic access for reading and writing operational data. Use it to build custom integrations, synchronize data with other systems, or automate operational workflows.

For endpoint documentation, see API Reference.

API documentation is being expanded. Contact your Maecos representative for early access and current endpoint availability.

Getting help

For integration support, contact your Maecos representative or reach out to [email protected]. Our team can assist with architecture guidance, credential provisioning, and troubleshooting.