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

# Connectors overview

> Every system DeskMate can talk to, and what setup each one needs.

A **connector** is the secure link between your DeskMate workspace and one of your business systems. Connectors handle authentication, token refresh, rate limits, and data normalisation — so that the skills your team writes only deal with clean, consistent data.

## Supported connectors

<CardGroup cols={2}>
  <Card title="Microsoft 365" icon="https://mintcdn.com/beenone/v25heXtR6zaKEpp6/images/connectors/microsoft.svg?fit=max&auto=format&n=v25heXtR6zaKEpp6&q=85&s=11356915d856178483cd5a2599065c4c" href="/connectors/microsoft-365" width="23" height="23" data-path="images/connectors/microsoft.svg">
    Outlook Mail, Calendar, Teams chats, OneDrive, SharePoint. Required for Teams chat bot.
  </Card>

  <Card title="Google Workspace" icon="https://mintcdn.com/beenone/v25heXtR6zaKEpp6/images/connectors/gmail.svg?fit=max&auto=format&n=v25heXtR6zaKEpp6&q=85&s=9e75bda41702ba763766773e8f2865b1" href="/connectors/google-workspace" width="24" height="24" data-path="images/connectors/gmail.svg">
    Gmail, Calendar, Drive, Contacts.
  </Card>

  <Card title="Xero" icon="https://mintcdn.com/beenone/v25heXtR6zaKEpp6/images/connectors/xero.svg?fit=max&auto=format&n=v25heXtR6zaKEpp6&q=85&s=d65932b691b2f54273a9d165571f7d3e" href="/connectors/xero" width="24" height="24" data-path="images/connectors/xero.svg">
    Invoices, contacts, bank transactions, chart of accounts.
  </Card>

  <Card title="QuickBooks Online" icon="https://mintcdn.com/beenone/v25heXtR6zaKEpp6/images/connectors/quickbooks.svg?fit=max&auto=format&n=v25heXtR6zaKEpp6&q=85&s=e37dd4e432caad4d60cac20d8a7a95c0" href="/connectors/quickbooks" width="24" height="24" data-path="images/connectors/quickbooks.svg">
    Customers, invoices, expenses, reports.
  </Card>

  <Card title="MYOB AccountRight" icon="https://mintcdn.com/beenone/v25heXtR6zaKEpp6/images/connectors/myob.svg?fit=max&auto=format&n=v25heXtR6zaKEpp6&q=85&s=5483082e8bdf9dd22fd298ad8ba89108" href="/connectors/myob" width="24" height="24" data-path="images/connectors/myob.svg">
    Customers, invoices, journal entries.
  </Card>

  <Card title="Attio" icon="https://mintcdn.com/beenone/v25heXtR6zaKEpp6/images/connectors/attio.svg?fit=max&auto=format&n=v25heXtR6zaKEpp6&q=85&s=f782bc3bfc97d30177fe01b51cb05cb8" href="/connectors/attio" width="24" height="24" data-path="images/connectors/attio.svg">
    CRM — people, companies, deals, notes, tasks.
  </Card>

  <Card title="Mailchimp" icon="envelopes-bulk" href="/connectors/mailchimp">
    Audiences, members, tags, campaigns.
  </Card>

  <Card title="Slack" icon="https://mintcdn.com/beenone/v25heXtR6zaKEpp6/images/connectors/slack.svg?fit=max&auto=format&n=v25heXtR6zaKEpp6&q=85&s=5628d3e86ba8cf7809082c8c41331e12" href="/connectors/slack" width="24" height="24" data-path="images/connectors/slack.svg">
    Used as the chat surface for DeskMate (not as a data source).
  </Card>
</CardGroup>

## How setup typically goes

Most connectors follow the same pattern:

1. **In your provider's admin console** — confirm an admin has the rights to install third-party apps.
2. **In DeskMate** — open **Workspace → Connectors** and click **Connect** on the tile.
3. **OAuth handshake** — you'll be redirected to the provider, asked to sign in and consent, and bounced back to DeskMate.
4. **Verify** — the connector tile turns green and shows "Connected".

Two connectors need a small amount of pre-work because they require an Azure or Intuit developer flow: [Microsoft 365](/connectors/microsoft-365) and [QuickBooks Online](/connectors/quickbooks). The guides walk you through it.

## What can go wrong (and how to spot it)

| Symptom                                     | Likely cause                                     | Where to look                               |
| ------------------------------------------- | ------------------------------------------------ | ------------------------------------------- |
| OAuth redirect URI mismatch                 | Wrong domain registered with the provider        | Provider's app registration → Redirect URIs |
| "Insufficient privileges" on Graph calls    | Application permissions not admin-consented      | Azure → Enterprise apps → Permissions       |
| Tokens keep expiring after one day          | Missing `offline_access` scope                   | Reconnect from Workspace                    |
| Connector shows green but skills can't read | Permission granted as Delegated, not Application | See provider-specific guide                 |

If you're stuck, email <a href="mailto:support@brightpathaisolutions.com">[support@brightpathaisolutions.com](mailto:support@brightpathaisolutions.com)</a> with the connector name, the error message, and a screenshot. We can usually unblock you within a few hours.

## Who can connect what

By default only **workspace admins** can add or remove connectors. Regular users can use the connectors that are already set up. The admin/member split is configured in **Workspace → Users**.