---
title: Connecting connectors: Guide in the XOS Help Center
description: A connector links XOS to a tool you already use, for example GitHub, Notion, Slack, HubSpot, Google Workspace, Microsoft 365 or your accounting software.
url: https://xos.prozessx.com/en/help/connecting-connectors/
---

[Help](https://xos.prozessx.com/en/help/) / Connectors All topics

Getting started

[What is XOS](https://xos.prozessx.com/en/help/what-is-xos/)[Login & initial setup](https://xos.prozessx.com/en/help/sign-in-setup/)[Layout & navigation](https://xos.prozessx.com/en/help/layout-navigation/)

Chat & agents

[Chat & sessions](https://xos.prozessx.com/en/help/chat-sessions/)[Model choice, dictation & canvas](https://xos.prozessx.com/en/help/chat-tools/)[Plan mode, web & deep research](https://xos.prozessx.com/en/help/plan-research/)[Agents, supervisor & specialists](https://xos.prozessx.com/en/help/agents-supervisor/)[Confirmations for critical actions](https://xos.prozessx.com/en/help/confirmations/)

Automation

[Building workflows](https://xos.prozessx.com/en/help/workflows/)

Connectors

[Connecting connectors](https://xos.prozessx.com/en/help/connecting-connectors/)[Permissions & approvals](https://xos.prozessx.com/en/help/connector-permissions/)[Available connectors](https://xos.prozessx.com/en/help/connector-list/)[Connecting external assistants](https://xos.prozessx.com/en/help/external-assistants/)

Workspace & files

[Knowledge base](https://xos.prozessx.com/en/help/knowledge-base/)[Workplaces](https://xos.prozessx.com/en/help/workplaces/)[Create documents (PPTX, Word, PDF)](https://xos.prozessx.com/en/help/documents/)

Communication & tasks

[Inbox](https://xos.prozessx.com/en/help/inbox/)[Activity & history](https://xos.prozessx.com/en/help/activity/)[Team chat](https://xos.prozessx.com/en/help/team-chat/)[Meetings](https://xos.prozessx.com/en/help/meetings/)[Tickets](https://xos.prozessx.com/en/help/tickets/)[Social Media](https://xos.prozessx.com/en/help/social-media/)

Daily Work

[Tasks](https://xos.prozessx.com/en/help/tasks/)[Projects](https://xos.prozessx.com/en/help/projects/)[Emails](https://xos.prozessx.com/en/help/emails/)[Telephony](https://xos.prozessx.com/en/help/telephony/)

Merchandise management (ERP)

[Overview](https://xos.prozessx.com/en/help/erp-overview/)

CRM & sales

[CRM](https://xos.prozessx.com/en/help/crm/)[Sales Hub](https://xos.prozessx.com/en/help/sales-hub/)

HR & marketing

[HR Hub](https://xos.prozessx.com/en/help/hr-hub/)[Marketing Hub](https://xos.prozessx.com/en/help/marketing-hub/)

Account & team

[Profile & password](https://xos.prozessx.com/en/help/profile-password/)[Invite & manage your team](https://xos.prozessx.com/en/help/manage-team/)[Organization & settings](https://xos.prozessx.com/en/help/organization/)[Usage, plans & billing](https://xos.prozessx.com/en/help/usage-billing/)

FAQ

[Frequently asked questions (FAQ)](https://xos.prozessx.com/en/help/faq/)

Support & status

[Known limitations & contact](https://xos.prozessx.com/en/help/limitations-contact/)

# Connecting connectors

[Manage connectors](https://xos.prozessx.com/workspace/agents)

## What connectors are

A connector links XOS to a tool you already use, for example GitHub, Notion, Slack, HubSpot, Google Workspace, Microsoft 365 or your accounting software. Every connected tool gets its own tile with its own agent on the [Connectors page](https://xos.prozessx.com/workspace/agents). The agent works in the tool on your behalf, for example creating issues, sending emails or finding contacts. From the tile you start a [chat](https://xos.prozessx.com/workspace/chat) with it directly.

The connection belongs to your personal account. The agent works with your permissions in the tool, not those of your colleagues. Everyone connects their own tools.

## Connect a connector

Depending on the tool, you connect by logging in with the provider (OAuth) or with an access key (API key). In the window, the icon on the right of each entry shows which way: an arrow for login, a key for credentials.

- Open the [Connectors page](https://xos.prozessx.com/workspace/agents) and click the Plus at the top right.
- In the Add connector (Connector hinzufügen) window, search for the tool in the Search connector… (Connector suchen…) field.
- Click the connector. For a login, the provider's popup opens: sign in with your own account and confirm access. The popup then closes by itself.
- For an access key, the Connect … (… verbinden) window opens instead. Enter the required values, such as API token (API-Token) , Subdomain or Agent email (Agent-E-Mail) , and click Connect (Verbinden) .
- The entry now shows Connected (Verbunden) , and the tool appears as a tile on the Connectors page.

Required fields have an asterisk. A hint on where to find the token appears as a placeholder in the field. If a key is already stored, the field shows already set (bereits gesetzt) . Leave it empty in that case and the old value is kept.

Credentials are stored encrypted and never shown in plain text. Connectors in the Coming soon (Bald verfügbar) section can't be connected yet.

## Login or access key?

- Login (OAuth) : You sign in with the provider once and allow XOS access. You don't have to copy anything. This is how it works for GitHub, GitLab, Notion, Linear, Asana, Microsoft 365, Zoom, Dropbox, Calendly and HubSpot, for example.
- Access key (API key) : You create a token in the tool and enter it in XOS. This is needed for tools without login authorization, for example sevDesk, Lexoffice, Zendesk, Monday.com, Personio or Stripe (customer invoicing).

## Check status, pause and disconnect

Every tile has a gear (Zahnrad) at the top right. It opens the connection settings.

- Connection status (Verbindungsstatus) : A green dot and Connected (Verbunden) show that everything is running, along with Connected since (Verbunden seit) and the granted access. If a connection has expired, it shows Access has expired, please reconnect (Zugriff ist abgelaufen, bitte neu verbinden) .
- Active for me (Für mich aktiv) : This switch pauses the connector without disconnecting it. The agent then temporarily has no access.
- My permission (Meine Berechtigung) : Your level for this tool: Read only (Nur lesen) , Write (Schreiben) or Full access (Vollzugriff) . Blocked (Gesperrt) means an admin has revoked access.

- Open the settings with the gear (Zahnrad) .
- To pause, switch off Active for me (Für mich aktiv) .
- To renew an expired connection, click Reconnect (Neu verbinden) under Manage connection (Verbindung verwalten) .
- To remove it, click Disconnect (Trennen) and confirm. The status changes to Not connected (Nicht verbunden) .

As an admin, you also see the Team access (Team-Zugriff) section in the settings (see Permissions & approvals).

[BackBuilding workflows](https://xos.prozessx.com/en/help/workflows/)[NextPermissions & approvals](https://xos.prozessx.com/en/help/connector-permissions/) On this page

[What connectors are](#was-sind-connectoren)[Connect a connector](#connector-verbinden)[Login or access key?](#login-vs-schluessel)[Check status, pause and disconnect](#status-pausieren-trennen)
