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

# Integrations

> Connect the services your agents act on.

An integration connects an external service so agent tools can act on it — read a
Drive folder, send an Outlook mail, list Teams chats.

<Note>
  This is not how users sign in. Signing in **with** an identity provider belongs to a
  commercial edition and is absent from the open-source build, which authenticates with
  email and password. See [Editions](/concepts/editions).
</Note>

## Connecting a workspace integration

<Steps>
  <Step title="Get the authorisation URL">
    `GET /api/integrations/{provider}/{service}/connect`
  </Step>

  <Step title="User consents">
    On the provider's consent screen.
  </Step>

  <Step title="Provider redirects back">
    `POST /api/integrations/{provider}/callback`
  </Step>

  <Step title="Tokens are stored encrypted">
    In the `integrations` table, encrypted with `ENCRYPT_KEY`.
  </Step>
</Steps>

Agent tools then use those tokens transparently.

## Supported services

| Provider  | Services                             | Scopes                                                    |
| --------- | ------------------------------------ | --------------------------------------------------------- |
| Google    | Drive, Gmail, Calendar, Sheets, Docs | Service-specific, e.g. `gmail.readonly`, `drive.readonly` |
| Microsoft | Outlook, Teams, OneDrive, SharePoint | Service-specific, e.g. `Mail.Read`, `Files.ReadWrite`     |
| GitHub    | Repositories, Gists                  | `repo`, `gist`, `read:user`                               |

## Endpoints

| Method | Endpoint                                        | Description                 |
| ------ | ----------------------------------------------- | --------------------------- |
| GET    | `/api/integrations`                             | List connected integrations |
| GET    | `/api/integrations/google/{service}/connect`    | Google authorisation URL    |
| POST   | `/api/integrations/google/callback`             | Google callback             |
| GET    | `/api/integrations/microsoft/{service}/connect` | Microsoft authorisation URL |
| POST   | `/api/integrations/microsoft/callback`          | Microsoft callback          |
| GET    | `/api/integrations/github/connect`              | GitHub authorisation URL    |
| POST   | `/api/integrations/github/callback`             | GitHub callback             |
| DELETE | `/api/integrations/{provider}`                  | Disconnect                  |


## Related topics

- [List Integrations](/api-reference/integrations/list-integrations.md)
- [Disconnect Integration](/api-reference/integrations/disconnect-integration.md)
- [Configuration](/configuration.md)
- [Odoo Connect](/api-reference/integrations/odoo-connect.md)
- [Github Callback](/api-reference/integrations/github-callback.md)