# Manage connected sources

> Connect Google Drive, Notion, Confluence, SharePoint, Dropbox, Box, Guru or BambooHR, and keep imported sources fresh.

Audience: HR administrators

Kind: How-to guide

Canonical: https://shuffl.ai/docs/connected-sources

<a id="availability"></a>
## Check availability first

Every provider imports single documents you pick and watches them for changes. Shuffl never writes back or crawls a drive, space or folder. Each import lands as a draft to review and publish.

Open Knowledge → Connections to connect a provider or request a new one. Google Drive, Notion, Dropbox, Box and SharePoint sign in with the provider; Confluence, Guru and BambooHR take a token you create. Tokens and grants are stored encrypted.

Signing in to Shuffl with Google does not connect Drive as a knowledge source; that is a separate consent.

- [Open Connections](https://shuffl.ai/app/knowledge/connections)

- [Use an article or a file instead](https://shuffl.ai/docs/knowledge)

- [Import an intranet page](https://shuffl.ai/docs/write-knowledge#intranet)

<a id="google-drive"></a>
## Google Drive

Connect Google Drive authorizes a separate selected-file connection. Import from Google Drive opens Google’s picker; each chosen Doc, Slides, PDF, Word, PowerPoint, text, Markdown or HTML file becomes a draft. Shuffl doesn’t list the rest of the Drive or edit the originals.

<a id="notion"></a>
## Notion

Connect Notion authorizes a read-only Shuffl connection. Share each policy page with that connection in Notion, then choose Add from Notion and paste the page link. Linked private pages, databases and meeting transcripts are not imported.

<a id="confluence"></a>
## Confluence

1. In Atlassian account settings, create an API token for the account that can read the HR spaces.

2. On Knowledge → Connections, choose Connect next to Confluence and enter the site URL (like acme.atlassian.net), the account email and the token.

3. From Add source, choose Add from Confluence, then search or paste a link.

Confluence Cloud connects with an Atlassian API token from id.atlassian.com under Security → API tokens. Shuffl reads only the pages that account can open.

Add from Confluence searches page titles or takes a pasted link. Headings become sections, and the page version is what Shuffl watches for changes.

<a id="dropbox"></a>
## Dropbox

1. On Knowledge → Connections, choose Connect next to Dropbox and sign in with the account that can open the files.

2. Approve read access for Shuffl.

3. From Add source, choose Add from Dropbox, then browse, search or paste a shared link.

Dropbox connects by signing in with the account that can open the HR folders, with read access only.

Add from Dropbox browses folders, searches file names or takes a shared link. Shuffl reads PDF, Word, PowerPoint, Markdown, HTML and text files; spreadsheets, images and older Office files are refused.

<a id="box"></a>
## Box

1. On Knowledge → Connections, choose Connect next to Box and sign in with the account that can open the files.

2. Grant Shuffl access.

3. From Add source, choose Add from Box, then browse, search or paste a link.

Box connects by signing in with the account that can open the HR folders.

Add from Box browses from All Files, searches file names or takes a pasted link. Shuffl reads PDF, Word, PowerPoint, Markdown, HTML and text files and watches each file’s version.

<a id="sharepoint"></a>
## SharePoint and OneDrive

1. On Knowledge → Connections, choose Connect next to SharePoint and OneDrive and sign in with the work account that can open the files.

2. Grant Shuffl read access to files and sites.

3. From Add source, choose Add from SharePoint and OneDrive, then browse, search or paste a sharing link.

SharePoint and OneDrive connect by signing in with the work account that can open the HR files, with read access to files and sites only.

Add from SharePoint and OneDrive starts at that account’s OneDrive and followed sites, searches file names or takes a sharing link. Shuffl reads PDF, Word, PowerPoint, Markdown, HTML and text files; spreadsheets, images and older Office files are refused.

<a id="guru"></a>
## Guru

1. In Guru, create a user token under My settings → API access, or a collection token.

2. On Knowledge → Connections, choose Connect next to Guru and enter the email or collection id and the token.

3. From Add source, choose Add from Guru, then pick a card or paste a link.

Guru connects with a user token from My settings → API access, or a collection token. Shuffl reads only the cards that token can open.

Add from Guru lists the verified cards in a collection, searches card titles or takes a card link. Unverified cards can be pasted but aren’t listed.

<a id="bamboohr"></a>
## BambooHR

1. In BambooHR, create an API key from your account menu.

2. On Knowledge → Connections, choose Connect next to BambooHR and enter the company domain and key.

3. From Add source, choose Add from BambooHR, then pick a file from a category.

BambooHR connects with an API key created by an administrator who can open company files, the same way People → Sync does.

Add from BambooHR lists the categories under Files, searches file names or takes a file link. Employee files are never listed or read.

<a id="freshness"></a>
## Read freshness and review states

A connected source is used in answers only while its last check is under an hour old and the administrator who connected the account can still use it. Check now requests a fresh read but publishes nothing.

Changes need review means the source has new text to review and publish; the older version stops being used as soon as a change is detected. Review due soon means its review date is close.

Sync needs attention, Access lost, Removed from source and Check overdue are recovery states; Access restored means a lost source can be read again.

<a id="recover"></a>
## Recover a source

1. Open the source and choose the provider’s name under Source to open the original and check that the connected account can still reach it.

2. Fix the access problem with the document owner. If the connection itself does not work, the administrator who connected it should check the account under Connected accounts.

3. Choose Check now if available. If a new draft is ready, review its text, audience and dates, then publish it. Restoring access does not republish a withdrawn document.

4. If unpublished HR edits block the new text, review those edits first.

5. Use source version opens Replace unpublished edits?; Replace with source creates a new draft and keeps the saved edits in version history.

<a id="disconnect"></a>
## Disconnect with care

Disconnect and withdraw deletes the stored credential and withdraws every document imported through that connection; drafts, versions and the originals stay. After reconnecting, sources need a fresh check, review and publication. For Google Drive, also remove the authorization in Google Account settings.

## Related guides

- [Review and publish knowledge](https://shuffl.ai/docs/knowledge)

- [Find a recovery step](https://shuffl.ai/docs/troubleshooting)

Agent documentation index: https://shuffl.ai/llms.txt