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

# Setting Up Integrations

> Connect mixus with your favorite tools and services through our select integrations

Connect mixus with your existing tools and workflows through our comprehensive integration library. With select integrations available, you can automate tasks and streamline processes across your entire tech stack.

## Overview

mixus integrations allow AI agents and chats to interact with external services seamlessly. Whether you need to read emails, update CRM records, post to social media, or analyze data, our integrations make it possible to build powerful automated workflows.

## How it works

Integration setup involves three main steps:

1. **Discovery**: Browse available integrations and select the ones you need
2. **Authentication**: Securely connect your accounts using OAuth or API keys
3. **Configuration**: Set permissions and customize how the integration behaves
4. **Testing**: Verify the connection works correctly before going live
5. **Usage**: Use integrations in chats, agents, and automated workflows

<Card title="Integration setup flow " icon="image">
  Image placeholder - To be added
</Card>

## Key features

### Extensive Integration Library

* **200+ Services**: From productivity tools to enterprise software
* **Popular Platforms**: Google Workspace, Microsoft 365, Slack, Salesforce, and more
* **Developer Tools**: GitHub, Jira, Docker, AWS, and other dev platforms
* **Social Media**: LinkedIn, Twitter, Facebook, Instagram management
* **E-commerce**: Shopify, WooCommerce, Stripe for business automation

### Secure Authentication

* **OAuth 2.0**: Industry-standard secure authentication
* **API Key Management**: Secure storage and rotation of API credentials
* **Scoped Permissions**: Grant only necessary access to your data
* **Token Encryption**: All credentials encrypted at rest and in transit

### Flexible Configuration

* **Custom Permissions**: Fine-tune what data and actions are available
* **Rate Limiting**: Automatic handling of API rate limits
* **Error Handling**: Robust retry logic and error reporting
* **Real-time Sync**: Live data synchronization where supported

## Getting started

### Prerequisites

* Active mixus account with integration permissions
* Admin access to the services you want to connect
* Understanding of what workflows you want to automate

### Accessing integrations

1. **Navigate to Integrations**

   * Go to your mixus dashboard
   * Click **"Integrations"** in the sidebar
   * Browse available services or use search

2. **Choose Integration Method**
   * **Individual Setup**: Connect services one by one
   * **Bulk Setup**: Connect multiple related services
   * **Team Setup**: Configure integrations for your organization

<Card title="Integration dashboard " icon="image">
  Image placeholder - To be added
</Card>

## Setting Up Common Integrations

### Google Workspace

#### Gmail Integration

1. **Start Setup**

   * Search for "Gmail" in integrations
   * Click **"Connect Gmail"**
   * Review required permissions

2. **Authenticate**
   ```text Gmail Permissions theme={null}
   ✓ Read emails
   ✓ Send emails
   ✓ Manage labels
   ✓ Search mailbox
   ✓ Access calendar (if selected)
   ```

````
3. **Configure Settings**
   - Set email monitoring preferences
   - Choose which folders to access
   - Configure notification settings

4. **Test Connection**
   ```text Gmail Test
# Test commands you can try:
   - "Check my recent emails"
   - "Send email to [contact] about [topic]"
   - "Find emails from [sender] about [subject]"
````

#### Google Drive Integration

1. **Connect Drive**

   * Find "Google Drive" in integrations
   * Authorize file access permissions
   * Select folders to include/exclude

2. **Set Permissions**
   ```text Drive Permissions theme={null}
   ✓ Read files and folders
   ✓ Create new documents
   ✓ Edit existing files
   ✓ Share files with others
   ✓ Manage folder structure
   ```

````
3. **Configure Sync**
   - Choose real-time vs scheduled sync
   - Set file type restrictions
   - Configure sharing permissions

### Slack Integration

#### Basic Setup
1. **Install App**
   - Search for "Slack" in integrations
   - Click **"Add to Slack"**
   - Select your Slack workspace

2. **Grant Permissions**
   ```text Slack Permissions
✓ Read channel messages
   ✓ Post messages
   ✓ Manage channels
   ✓ Access user information
   ✓ Upload files
````

3. **Configure Channels**
   * Select which channels to monitor
   * Set up notification preferences
   * Configure bot mention settings

#### Advanced Configuration

```json Slack Configuration theme={null}
{
  "channels": {
    "monitor": ["#general", "#support", "#alerts"],
    "post_to": ["#bot-updates", "#notifications"],
    "exclude": ["#private", "#hr"]
  },
  "permissions": {
    "read_messages": true,
    "post_messages": true,
    "manage_channels": false,
    "admin_actions": false
  },
  "notifications": {
    "mentions": true,
    "keywords": ["urgent", "help", "mixus"],
    "dm_notifications": true
  }
}
```

### Salesforce Integration

#### CRM Setup

1. **Connect Salesforce**

   * Find Salesforce in integrations
   * Use your Salesforce admin credentials
   * Configure object access permissions

2. **Set Object Permissions**
   ```text Salesforce Objects theme={null}
   ✓ Leads
   ✓ Contacts
   ✓ Accounts
   ✓ Opportunities
   ✓ Cases
   ✓ Custom Objects (as needed)
   ```

````
3. **Configure Field Access**
   - Choose which fields to read/write
   - Set up field mapping for automation
   - Configure validation rules

4. **Test Operations**
   ```text Salesforce Test Commands
# Test with these commands:
   - "Show me recent leads"
   - "Create contact for [name] at [company]"
   - "Update opportunity [name] to closed won"
   - "Find all accounts in [region]"
````

## Advanced Setup Options

### Enterprise Configurations

#### Single Sign-On (SSO)

For enterprise customers with SSO requirements:

```json SSO Configuration theme={null}
{
  "sso_provider": "okta",
  "domain": "company.okta.com",
  "auto_provision": true,
  "group_mapping": {
    "admin": "mixus-admins",
    "user": "mixus-users",
    "integration-manager": "mixus-integrations"
  },
  "session_timeout": 8
}
```

#### Custom API Endpoints

Connect to internal or custom APIs:

```json Custom API Setup theme={null}
{
  "name": "Internal CRM",
  "base_url": "https://api.company.com/v1",
  "authentication": {
    "type": "bearer_token",
    "token": "your-api-token"
  },
  "endpoints": {
    "customers": "/customers",
    "orders": "/orders",
    "products": "/products"
  },
  "rate_limits": {
    "requests_per_minute": 100,
    "burst_limit": 200
  }
}
```

### Webhook Configurations

Set up webhooks for real-time updates:

```json Webhook Setup theme={null}
{
  "webhook_url": "https://api.mixus.ai/webhooks/your-endpoint",
  "events": ["new_lead", "status_change", "form_submission"],
  "authentication": {
    "type": "signature",
    "secret": "your-webhook-secret"
  },
  "retry_policy": {
    "max_attempts": 3,
    "backoff": "exponential"
  }
}
```

## Best Practices

### Security Considerations

1. **Principle of Least Privilege**

   * Grant only necessary permissions
   * Regularly review and audit access
   * Use separate accounts for integrations when possible

2. **Credential Management**

   * Use OAuth over API keys when available
   * Rotate credentials regularly
   * Monitor for unauthorized access

3. **Data Protection**
   * Understand what data is being accessed
   * Configure appropriate data retention policies
   * Ensure compliance with privacy regulations

### Performance Optimization

1. **Rate Limit Management**

   * Understand each service's rate limits
   * Implement backoff strategies
   * Use batch operations when available

2. **Efficient Data Sync**

   * Configure incremental sync where possible
   * Filter data at the source
   * Use webhooks for real-time updates

3. **Error Handling**
   * Implement retry logic for transient failures
   * Set up monitoring and alerting
   * Plan for service outages

### Integration Maintenance

1. **Regular Health Checks**

   ```bash Health Check Commands theme={null}
   ```

# Test integration status

/test-integration \[service-name]

# Check authentication status

/integration-status

# Refresh connection

/refresh-auth \[service-name]

```

2. **Monitor Usage**
   - Track API usage and costs
   - Monitor performance metrics
   - Review error logs regularly

3. **Update Management**
   - Stay informed about API changes
   - Test integrations after service updates
   - Plan for deprecations and migrations

## Troubleshooting

### Common Issues

#### Authentication Failures

**Problem**: OAuth flow fails or tokens expire
**Solutions**:
- Clear browser cache and cookies
- Check if service account has necessary permissions
- Verify redirect URLs are correctly configured
- Try re-authenticating from scratch

**Problem**: API key authentication fails
**Solutions**:
- Verify API key is correctly copied
- Check if API key has expired
- Ensure API key has necessary scopes
- Test API key directly with service's API

#### Permission Errors

**Problem**: Integration can't access required data
**Solutions**:
- Review and expand integration permissions
- Check service-specific role assignments
- Verify organization admin has granted access
- Contact service administrator if needed

#### Rate Limiting Issues

**Problem**: Integration hits rate limits frequently
**Solutions**:
- Reduce frequency of automated actions
- Implement intelligent batching
- Upgrade service plan if available
- Use webhooks instead of polling

#### Data Sync Problems

**Problem**: Data isn't syncing correctly
**Solutions**:
- Check service status pages for outages
- Verify data formats and field mappings
- Review integration logs for errors
- Test with manual sync operations

### Getting Help

If you encounter persistent issues:

1. **Check Integration Status**
   - Review the integration health dashboard
   - Look for service-specific status updates
   - Check our [status page](https://status.mixus.ai)

2. **Review Documentation**
   - Check service-specific setup guides
   - Review [troubleshooting guide](/support/troubleshooting)
   - Consult service provider documentation

3. **Contact Support**
   - Email [support@mixus.com](mailto:support@mixus.com)
   - Include integration name and error details
   - Provide screenshots of error messages
   - Mention your mixus organization ID

## Integration Limits

### Account Limits
- **Free Plan**: Up to 3 integrations
- **Pro Plan**: Up to 15 integrations
- **Team Plan**: Up to 50 integrations
- **Enterprise Plan**: Unlimited integrations

### Usage Limits
- **API Calls**: Varies by integration and plan
- **Data Transfer**: Subject to service provider limits
- **Webhook Events**: Based on your plan tier
- **Storage**: For cached integration data

### Service-Specific Limits
Different services have their own limitations:
- **Google**: Daily API quotas and rate limits
- **Salesforce**: API call limits based on edition
- **Slack**: Message rate limits and app limits
- **Microsoft**: Throttling and usage policies

## Related Features

- [AI Agents](/agents/overview) - Use integrations in automated workflows
- [Chat Tools](/ai-tools/overview) - Access integrations directly in conversations
- [Team Management](/multiplayer/overview) - Share integrations across your team
- [Security Settings](/security/overview) - Manage integration security

## What's Next?

Ready to connect your first integration? Here are your next steps:

1. **[Browse available integrations](/integrations/available)** to see what's possible
2. **[Set up your first agent](/agents/creating)** that uses integrations
3. **[Explore automation examples](/agents/examples)** for inspiration
4. **[Learn about team collaboration](/multiplayer/overview)** with shared integrations

---

*Need help with a specific integration? Contact our [integrations team](mailto:support@mixus.com) or check our [integration-specific guides](/integrations/available).*
```