Connectors Overview

DatumOS connectors integrate your existing business tools and data sources directly into your AI conversations. Connect once, and DatumOS securely accesses your files, emails, calendar events, and project data when you need them.

What are Connectors?

Connectors are secure integrations that allow DatumOS to:

• Search across your documents, emails, and project files
• Retrieve specific information when answering your questions
• Create new documents, calendar events, and tasks (where supported)
• Sync data automatically to keep information current

All connector access is controlled by you through OAuth authentication. You decide which services to connect and can disconnect at any time.

Available Connectors

Autodesk ACC

Access construction documents, BIM models, RFIs, and issues from Autodesk Construction Cloud

Microsoft 365

Search and manage files in OneDrive, emails in Outlook, and calendar events

Google Workspace

Access Google Drive files, Gmail messages, and Google Calendar events

How Connectors Work

1. Connect Your Account

Navigate to Settings → Connectors and click Connect next to the service you want to add. You’ll be redirected to the provider’s OAuth authorization page to grant access.

2. Authorize Permissions

Each connector requests specific permissions (called “scopes”) to access your data:

• Read permissions - Search and retrieve files, emails, events
• Write permissions - Create documents, send emails, add calendar events (optional)

You can review the exact permissions requested before connecting.

3. Use in Conversations

Once connected, simply ask DatumOS to search or access information:

“Find the latest project schedule in my OneDrive”

“Search my Autodesk ACC for RFIs about the electrical scope”

“What meetings do I have tomorrow?”

DatumOS automatically determines which connector to use based on your question.

Data Access Model

Security & Privacy

• OAuth 2.0 Authentication - Industry-standard secure authorization
• Scoped Access - Connectors only access data you explicitly authorize
• Token Storage - Access tokens are encrypted and stored securely
• No Data Storage - DatumOS does not permanently store the content from your connected services
• User Control - Disconnect any connector at any time from Settings

Sync Behavior

All connectors fetch the latest data in real-time when you ask a question.

Connection Status

Monitor your connector health in Settings → Connectors:

• Connected (Green) - Active and working normally
• Expired (Yellow) - Token needs refresh (click Reconnect)
• Disconnected (Gray) - Not connected or manually disconnected
• Error (Red) - Connection failed (check Help documentation)

Reconnecting Accounts

OAuth tokens expire periodically for security. When a connector shows as Expired:

1. Go to Settings → Connectors
2. Click Reconnect next to the expired connector
3. Complete the OAuth flow again
4. Resume using the connector immediately

Permissions & Scopes

Each connector requests the minimum permissions needed to function. You can review detailed permission information on each connector’s documentation page:

• Autodesk ACC Permissions
• Microsoft 365 Permissions
• Google Workspace Permissions

Rate Limits

Connectors respect the rate limits imposed by each service provider:

• Autodesk ACC - 100 requests per minute per user
• Microsoft 365 - Varies by API (see Microsoft Graph documentation)
• Google Workspace - Varies by API (see Google API documentation)

If you encounter rate limit errors, wait a few minutes before retrying. DatumOS automatically implements retry logic with exponential backoff.

Troubleshooting

Common issues and solutions:

For detailed troubleshooting, see the Help Center.

Next Steps