How to Connect OneDrive to Appalix
Index Word documents, PDFs, or any file stored in Microsoft OneDrive so your AI bot can answer questions from them. Appalix uses the Microsoft Graph API with a read-only access token.
What you'll need
- An Appalix account on the Pro plan or above
- A Microsoft account (personal or work/school) with access to the file
- A configured bot in Appalix with RAG enabled
Step 1 — Copy the OneDrive file URL
- Open OneDrive and navigate to the file.
- Right-click the file → Share → Copy link. The link looks like:
https://1drv.ms/w/s!AbcDef123…
For work or school accounts you can also use the direct URL from the browser address bar when the file is open.
Step 2 — Generate a Microsoft Graph access token
The easiest way is via Microsoft Graph Explorer. Graph Explorer only shows permissions relevant to the active query, so you must run a OneDrive query first to surface Files.Read.
- Go to developer.microsoft.com/graph/graph-explorer.
- Click Sign in to Graph Explorer and sign in with your Microsoft account.
- In the request URL bar at the top, replace the default URL with:
https://graph.microsoft.com/v1.0/me/drive/root
Click Run query. It will return an error — that's expected. - A blue Modify permissions banner will appear below the request bar (or click the Modify permissions tab). You will now see
Files.ReadandFiles.Read.Allin the list. - Click Consent next to
Files.Readand approve the pop-up. - Run the query again — it should now return your OneDrive root folder details.
- Copy your access token — there are two ways depending on the Graph Explorer version you see:
- Tab method (most common): Look at the response panel below the URL bar. Click the Access token tab (it sits next to “Response preview” and “Response headers”). The full token is shown — click Copy.
- Profile icon method: At the very top-right of the page, click your profile picture or initials circle (next to the bell icon). A dropdown appears — click Access token. The token is shown in a pop-up — click Copy.
eyJ0…; personal Microsoft accounts (Outlook/Live) get a token starting withEwB…. Both are correct.
https://developer.microsoft.com/…#:~:text=eyJ0… — that is not your token. Always use the Copy button inside Graph Explorer (the button next to the token text), not the browser address bar.Step 3 — Add the source in Appalix
- In Appalix, go to Sources → Add source and select OneDrive.
- Enter a Source name (e.g. Sales Playbook).
- Paste the OneDrive file URL from Step 1.
- Paste the Microsoft Graph access token from Step 2 (starts with
eyJ0…orEwB…). - Click Add & index source.
Step 4 — Verify the source is ready
- Go to Sources — the OneDrive source will show Processing while indexing.
- Once it shows Ready, your bot can answer questions from that file.
- Test it in the Playground.
Tips & best practices
- One file per source — add each OneDrive file separately for granular re-syncing.
- Re-sync after edits — when the file changes, click Re-sync on the source in Appalix.
- Work/school vs personal — Graph Explorer works for both account types. The scopes required are the same.
- Production tokens — register an app in Azure Portal → Azure Active Directory → App registrations to generate non-expiring tokens.
🗂️
Index your OneDrive files in minutes
Sign in to Microsoft Graph Explorer, copy the access token, and paste it into Appalix alongside your file URL. Your bot will be answering from your documents right away.
Go to Sources →