> ## 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 Health OS Integrations

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

This directory contains integration guides for connecting Encore Health 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.md).

> **See also:** [Integrations and Settings Review](./INTEGRATIONS_AND_SETTINGS_REVIEW.md) (2026-03-23) — integration and settings documentation gaps and recommendations.

## Available Integrations

### [n8n Workflow Automation](./N8N_INTEGRATION_GUIDE.md)

Connect Encore Health 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 Health OS uses a hybrid approach for automation:

* **Encore Health 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 Health 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](./N8N_INTEGRATION_GUIDE.md#n8n-setup)
2. **Create webhook**: Add a webhook trigger to your n8n workflow
3. **Configure Encore Health 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.md)

***

## Documentation

### Integration Guides

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

### Related Documentation

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

## Support

For questions or issues:

* Review the [n8n Integration Guide](./N8N_INTEGRATION_GUIDE.md)
* Check [Integrations and Settings Review](./INTEGRATIONS_AND_SETTINGS_REVIEW.md) for setup guides
* Consult [Integration Documentation](../architecture/integrations/index.md) for integration contracts and patterns