Connectors

Trame uses Composio’s connector platform to integrate with 100+ external systems including Gmail, Slack, CRM/ERP platforms, and more. Only connected toolkits are available to workflows, so connector health directly affects what can run.

Composio Integration Platform

How Trame Uses Composio

Trame leverages Composio’s enterprise-grade integration platform:

100+ Pre-built Connectors: Access to extensive library of business integrations
OAuth Management: Secure, standardized authentication across all platforms
Tool Discovery: Automatic detection of available actions and triggers
Enterprise Security: SOC 2 compliant with enterprise-grade security controls
Scalable Architecture: High-performance API infrastructure for reliable integrations

Available Connector Categories

Connectors are organized by business function:

Communication: Slack, Discord, Microsoft Teams, Zoom
Email: Gmail, Outlook, Yahoo Mail, SendGrid
Productivity: Google Workspace, Microsoft 365, Notion, Airtable
CRM: Salesforce, HubSpot, Pipedrive, Zoho CRM
E-commerce: Shopify, WooCommerce, Magento, Square
Developer Tools: GitHub, GitLab, Jira, Linear
Finance: QuickBooks, Xero, Stripe, PayPal
Marketing: Mailchimp, ConvertKit, ActiveCampaign

Connection Requirements

OAuth Permissions: Your organization must have permission to authorize the target system
Connector Availability: Toolkit must be enabled for your organization tier
Valid Credentials: Active account on the target platform with appropriate permissions
Network Access: Ability to reach external APIs (typically not an issue for cloud-hosted systems)

Connecting a toolkit

Connection Process

Access Connectors Page: Navigate to Connectors in your organization workspace
Browse Available Connectors: View enabled and coming-soon integrations in categorized tabs
Initiate Connection: Click on a connector to start the OAuth authorization flow
Complete Authorization: Redirect to provider’s consent screen (e.g., Google, Slack, Salesforce)
Verify Connection: Return to Trame with connection status confirmed
Monitor Health: Connection status updates automatically with health checks

Connection States

Connectors display one of several status indicators:

Connected: Healthy connection ready for workflow use (green indicator)
Needs Attention: Connection error requiring reconnection (red indicator)
Not Connected: Available but not yet authorized (yellow indicator)
Coming Soon: Planned connectors not yet available (gray indicator)

Connection Management

Each connected toolkit provides:

Status Monitoring: Real-time health checks and status updates
Reconnection Options: Easy reconnection for expired or broken connections
Audit Trail: Complete history of connection events in audit logs
Permission Scope: Clear indication of what access has been granted
Connection Details: External connection IDs and configuration information

Connector Capabilities

Tools and Actions

Connected toolkits expose specific actions workflows can use:

Communication Actions: Send messages, create channels, notify users
Data Management: Create records, update fields, search databases
File Operations: Upload documents, create folders, share files
Workflow Triggers: Start processes, send notifications, create tasks
Integration Specific: Platform-specific actions (e.g., GitHub commits, Stripe payments)

Event Triggers

Many connectors provide trigger events for automatic workflow execution:

Real-time Events: New emails, messages, form submissions, record changes
Scheduled Events: Daily reports, weekly summaries, monthly reviews
Conditional Events: Threshold alerts, status changes, approval requests
Custom Events: Webhook endpoints for custom application integration

Composio Tool Discovery

The platform automatically discovers available capabilities:

Dynamic Tool Loading: Available actions update when connectors are added
Permission-Aware: Only shows actions your connection permissions support
Version Management: Handles API version updates automatically
Error Handling: Graceful degradation when tools become unavailable

Runtime behavior

If a workflow requires a toolkit that is not connected, planning will warn and execution will fail the capability check.
Triggered workflows run only when the toolkit is connected; paused/draft workflows ignore trigger events.
Disconnecting removes the connector from your org; if the provider cannot be reached, you’ll see a warning to retry.

Advanced Connector Features

Health Monitoring

Trame continuously monitors connector health:

Automatic Health Checks: Regular validation of connection status
Error Detection: Immediate notification of connection issues
Performance Monitoring: API response times and rate limit tracking
Proactive Alerts: Warnings before connections expire or fail

Organization Dashboard Integration

Connectors integrate with the main dashboard:

Connection Health Metrics: Overall percentage of healthy connections
Usage Statistics: Most and least used connectors in your organization
Integration Recommendations: Suggestions for additional beneficial connectors
Quick Actions: Easy access to connector management from dashboard

Security and Compliance

Composio provides enterprise-grade security:

SOC 2 Compliance: Audited security controls and processes
Encrypted Storage: All credentials encrypted at rest and in transit
Minimal Permissions: Request only necessary OAuth scopes
Regular Security Updates: Automatic security patches and updates
Audit Compliance: Complete audit trails for security reviews

Troubleshooting Connection Issues

Common Problems and Solutions

Connection Status “Needs Attention”

Expired Credentials: Reconnect to refresh OAuth tokens
Permission Changes: Re-authorize if target system permissions changed
API Changes: Wait for automatic updates or contact support
Rate Limits: Reduce workflow frequency or contact provider about limits

Connection Fails to Establish

Account Permissions: Verify you have admin access to authorize the integration
Network Issues: Check firewall settings and network connectivity
Browser Problems: Try different browser or clear cookies/cache
OAuth Configuration: Ensure OAuth settings are correct on provider side

Tools or Triggers Not Available

Connection Required: Ensure the relevant connector is connected and healthy
Permission Scope: Verify OAuth permissions include required access
Plan Limitations: Check if connector is available in your organization plan
Provider Changes: API changes may temporarily affect tool availability

Getting Help

When connection issues persist:

Audit Logs: Review connector-specific events in organization audit logs
Error Messages: Note specific error messages for support requests
Browser Console: Check browser developer tools for additional error details
Support Contact: Reach out with connector name, error message, and organization details

Best Practices for Connector Management

Regular Health Checks: Monitor connector status in organization dashboard
Permission Reviews: Regularly review and update OAuth permissions
Documentation: Keep track of which connectors are used by which workflows
Team Training: Ensure team members understand connector requirements and limitations