> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Encore OS Integrations

> This directory contains integration guides for connecting Encore OS with external services and platforms (Supabase, n8n, Entra ID, RingCentral, etc.). C…

This directory contains integration guides for connecting Encore OS with **external services and platforms** (Supabase, n8n, Entra ID, RingCentral, etc.). Cross-core integration contracts and per-spec integration docs live under [architecture/integrations](/architecture/integrations/index).

## Available Integrations

### [n8n Workflow Automation](/integrations/N8N_INTEGRATION_GUIDE)

Connect Encore OS automations to n8n workflows for advanced external integrations, multi-step orchestration, and connecting to 400+ services.

**Use Cases:**

* Sync form submissions to CRMs (Salesforce, HubSpot)
* Send notifications via Slack, Teams, or SMS
* Update Google Sheets or Airtable
* Trigger multi-step approval workflows
* Connect to custom APIs and services

***

## Integration Architecture

Encore OS uses a hybrid approach for automation:

* **Encore OS FW-03 Engine**: Internal workflows, database operations, notifications, simple integrations
* **n8n**: Complex external integrations, visual workflow design, branching logic, 400+ pre-built connectors

### When to Use Each

| Capability             | Encore OS (FW-03) | n8n                   |
| ---------------------- | ----------------- | --------------------- |
| Form-triggered actions | ✅ Primary         | ⚡ Extended workflows  |
| Database updates       | ✅ Primary         | ❌ Not recommended     |
| Send notifications     | ✅ Primary         | ⚡ For complex routing |
| External API calls     | ⚡ Simple webhooks | ✅ Primary             |
| Multi-step workflows   | ⚡ Basic           | ✅ Primary             |
| Conditional branching  | ⚡ Basic           | ✅ Advanced            |
| CRM/SaaS integrations  | ❌ Manual webhooks | ✅ 400+ connectors     |
| Visual workflow design | ❌ N/A             | ✅ Drag-and-drop       |

***

## Getting Started

1. **Set up n8n**: [Follow the n8n setup guide](/integrations/N8N_INTEGRATION_GUIDE#n8n-setup)
2. **Create webhook**: Add a webhook trigger to your n8n workflow
3. **Configure Encore OS**: Add "Call Webhook" action to your automation rule
4. **Test integration**: Use dry-run mode to validate the connection

***

## Security Considerations

* Always use HTTPS for webhook URLs
* Implement authentication (Basic Auth, API Key, or Header Auth)
* Never log sensitive data (PHI, PII, credentials)
* Use circuit breakers to prevent runaway automations
* Review [Automation Security documentation](/security/AUTOMATION_SECURITY)

***

## Documentation

### Integration Guides

* [n8n Workflow Automation](/integrations/N8N_INTEGRATION_GUIDE) - External workflow integration
* [Edge Functions](/integrations/EDGE_FUNCTIONS) - Complete documentation for all 48 edge functions
* [Supabase Setup](/integrations/SUPABASE_SETUP) - Production Supabase configuration guide
* [Email & SMS Setup](/integrations/EMAIL_SMS_SETUP) - Entra/Gmail and RingCentral configuration
* [RingCentral Gap Analysis](/integrations/RINGCENTRAL_GAP_ANALYSIS) - RingCentral integration analysis and recommendations
* [Entra ID Integration](/integrations/ENTRA_ID_OVERVIEW) - Microsoft Entra ID/Office 365 integration overview
  * [Setup Guide](/integrations/ENTRA_ID_SETUP) - Complete setup instructions
  * Gap Analysis (archived; superseded by PF-63 implementation — see ENTRA\_ID\_GAP\_ANALYSIS.md)
  * [Research Findings](/integrations/ENTRA_ID_RESEARCH_FINDINGS) - Programmatic app registration research

### Related Documentation

* [FW-03 Automation Engine spec](https://github.com/Encore-OS/encoreos/blob/development/specs/fw/archive/FW-03-automation-engine.md) - Automation engine specification
* [Integration Documentation](/architecture/integrations/index) - Cross-core integration contracts and patterns
* [Environment Variables](/development/ENVIRONMENT_VARIABLES) - Environment configuration guide
* [Secrets Management](/security/SECRETS_MANAGEMENT) - Secrets management strategy

## Support

For questions or issues:

* Review the [n8n Integration Guide](/integrations/N8N_INTEGRATION_GUIDE)
* Consult [Integration Documentation](/architecture/integrations/index) for integration contracts and patterns