Resources/Connect OneDrive to Appalix
Tutorial8 min read · Pro plan and above

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

  1. Open OneDrive and navigate to the file.
  2. 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.

  1. Go to developer.microsoft.com/graph/graph-explorer.
  2. Click Sign in to Graph Explorer and sign in with your Microsoft account.
  3. 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.
  4. A blue Modify permissions banner will appear below the request bar (or click the Modify permissions tab). You will now see Files.Read and Files.Read.All in the list.
  5. Click Consent next to Files.Read and approve the pop-up.
  6. Run the query again — it should now return your OneDrive root folder details.
  7. 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.
    The token is a long string. Work/school (Azure AD) accounts get a JWT starting with eyJ0…; personal Microsoft accounts (Outlook/Live) get a token starting with EwB…. Both are correct.
Common mistake — do not copy the browser URL! After highlighting the token text on the page, some browsers (Chrome, Edge) let you “copy link to highlight”. If you accidentally copy the address bar you'll get a URL like 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.
Note: Graph Explorer tokens expire after ~1 hour. For production, register an Azure AD app and use the client credentials flow to generate long-lived tokens.

Step 3 — Add the source in Appalix

  1. In Appalix, go to Sources → Add source and select OneDrive.
  2. Enter a Source name (e.g. Sales Playbook).
  3. Paste the OneDrive file URL from Step 1.
  4. Paste the Microsoft Graph access token from Step 2 (starts with eyJ0… or EwB…).
  5. Click Add & index source.

Step 4 — Verify the source is ready

  1. Go to Sources — the OneDrive source will show Processing while indexing.
  2. Once it shows Ready, your bot can answer questions from that file.
  3. 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 →
📬

Stay ahead of the curve

Get new guides, case studies, and product updates delivered to your inbox every two weeks.

No spam. Unsubscribe any time.