Learn
Connect integrations
Integrations are the systems your digital workers act through: email, chat, your CRM, project tools, accounting and more. Most connect in a single click; you never register an app or handle any technical credentials. And whatever you connect, every action that changes something still waits for a human in the Approval Centre.
How connecting works
Open Integrations in the app and press Connect on the system you want. There are two ways a connector links, and the app tells you which one applies:
- One-click You're taken to the provider's own sign-in and consent screen (Google, Microsoft, Slack, and so on). You approve the access, and you're returned to SyftOS already connected. No keys, no configuration.
- Bring your own key You paste a key or token the provider gives you (for example a Stripe restricted key, or a GitHub personal access token). It's stored encrypted and never shown again.
The connectors
Each connector gives your agents a focused set of tools. Reads happen automatically as an agent works; anything under With approval is a change to the outside world, so it pauses for a person to approve or reject. Access is least-privilege. A connector can only do what's listed here.
Gmail One-click
- Reads: searches your mailbox and returns matching messages.
- With approval: drafts an email; sends an email.
Outlook One-click
- Reads: searches your mailbox and returns matching messages.
- With approval: drafts an email; sends an email.
Google Drive & Sheets One-click
- Reads: searches your Drive for files; reads a range of cells from a Sheet.
- With approval: creates a file or Google Doc; appends rows to a Sheet; overwrites cells in a Sheet.
Slack One-click
- Reads: lists public channels; reads recent channel history; looks up a member's profile.
- With approval: posts a message; replies in a thread; schedules a message for later.
Jira One-click
- Reads: lists projects; searches issues; fetches an issue; lists the transitions available on an issue.
- With approval: creates an issue; comments on an issue; moves an issue through a workflow transition; updates an issue's summary or description.
Teamwork One-click or key
- Reads: lists projects; lists tasks in a project.
- With approval: creates a task; comments on a task; updates a task.
HubSpot One-click
- Reads: searches contacts and deals; fetches a contact or a company.
- With approval: creates a contact, a company, a task or a note; moves a deal to a different pipeline stage.
Xero One-click
- Reads: lists contacts, invoices and bank transactions; gets the Profit & Loss report.
- With approval: creates a sales invoice; creates a bill; emails an invoice to its contact.
Stripe Bring your own key
- Reads: lists customers, charges, invoices and subscriptions; reads the account balance.
- With approval: creates a customer; creates a draft invoice; issues a refund.
GitHub One-click or key
- Reads: lists repositories, issues and commits; fetches a pull request.
- With approval: creates an issue; comments on an issue or pull request; adds labels.
Approval & security
- Nothing acts on its own. Every "with approval" tool above raises a request a person decides; agents can never approve their own actions. Connecting a system grants the ability to act through it, never unattended action.
- Credentials are encrypted at rest, scoped to your organisation, and shown only once — they never appear in logs, run history or the audit trail.
- Least-privilege access. Each connector requests only the permissions its tools need, never more.
- Disconnect any time from a connector's page; its stored credentials are removed and its tools stop working immediately.
GitHub: two places, two jobs
GitHub appears twice in SyftOS, both deliberate, for different work:
- Integrations → GitHub: GitHub as an agent tool (the connector above). Your workers read repositories, issues and pull requests and, with approval, open issues, comment and label.
- Govern → Repositories: Code Governance. SyftOS reviews pull requests raised by third-party coding agents (Cursor, Copilot, Devin, Claude Code, Codex). It governs the change (review, approve, reject) and never runs your repository's code.
Troubleshooting
- A connector shows as unavailable. That provider hasn't been enabled on the platform yet. Contact support (or your SyftOS administrator) to have it switched on.
- The provider's consent screen shows an error or won't return you to SyftOS. That's a platform configuration issue, not something you can fix from your account. Let us know which connector and we'll sort it.
- A connection stops working. Access can expire or be revoked at the provider. Open the connector's page and reconnect; in-flight work resumes once it's healthy again.
- A workflow fails mentioning the AI model provider (not a connector). That's the language-model service, configured separately from your integrations. Contact support or your administrator.