# Manage connected sources

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

Audience: HR administrators

Canonical: https://shuffl-rebuild.vercel.app/docs/connected-sources

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

Every provider below imports single documents you pick, watches them for changes and 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 one Shuffl does not offer yet. 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. After connecting, Add source lists Add from that provider.

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

- [Open Connections](https://shuffl-rebuild.vercel.app/app/manage/inbox/connections)

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

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

Connect Google Drive authorizes a separate selected-file connection. Import from Google Drive opens Google’s own picker; each chosen Doc, Slides, PDF, Word, PowerPoint, text, Markdown or HTML file becomes a draft for review. Shuffl reads selected files without listing the rest of the Drive or editing 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 pasted shared link. Shuffl reads PDF, Word, PowerPoint, Markdown, HTML and text files and watches each file’s revision; 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 the sites it follows, searches file names or takes a pasted sharing link. Shuffl reads PDF, Word, PowerPoint, Markdown, HTML and text files and watches each file’s version; 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 pasted card link. Unverified cards are left out of the list but can be pasted. Headings become sections, and the last-modified time is what Shuffl watches.

<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 pasted file link. Shuffl reads PDF, Word, PowerPoint, Markdown, HTML and text files and watches each file’s upload date and size. 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. Sync needs attention, Access unavailable and Check overdue are recovery states.

Sync needs attention, Access unavailable and Check overdue are recovery states. Check the source status and the original document before relying on an answer.

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

1. Open the source and choose Open original to check that the document still exists and the connected account can 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 it is available and read the result. 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. 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 connection credential and withdraws every document imported through that connection; stored drafts and versions remain, and the originals are untouched. Check which employee sources will become unavailable first. After reconnecting, sources need a fresh check, review and publication. For Google Drive, remove any remaining authorization in Google Account settings.

## Related guides

- [Review and publish knowledge](https://shuffl-rebuild.vercel.app/docs/knowledge)

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

Agent documentation index: https://shuffl-rebuild.vercel.app/llms.txt