Box

Monitor your Box cloud storage for newly shared files, modified documents, and pending tasks.

Quick Setup

Box uses OAuth via the official Box Developer Console. Phyllax doesn't yet bundle a Box OAuth app, so you create your own.

1. Go to app.box.com/developers/console
2. Create a Custom App → choose User Authentication (OAuth 2.0)
3. Under App Access Level, pick App + Enterprise Access (or App Access only, depending on your scope needs)
4. Under Application Scopes, enable: Read all files and folders, Write all files and folders, Manage tasks
5. Under OAuth 2.0 Redirect URI, add: http://localhost:4389/oauth/callback
6. Save changes and Submit for Review (some Box workspaces require admin approval before the app can connect)
7. Copy the Client ID and Client Secret
8. In Phyllax → Integrations → Box → enter Client ID, Client Secret → Connect
9. Browser opens → sign in → grant → done

Required Credentials

Field	Where to find it
Client ID	Box Developer Console → Your App → Configuration → OAuth 2.0 Credentials
Client Secret	Same place

What Phyllax Monitors

Schedule	What it checks
Recently shared files	Files someone shared with you in the last N hours
Modified documents	Documents you own that were edited by collaborators
Pending tasks	Box tasks assigned to you that are due soon or overdue
Storage near quota	Alerts when you approach your Box storage limit

Notification Actions

Each Box notification card includes:

• Open — open the file in Box's web UI
• Download — download a copy locally
• Add task — create a follow-up task on the file
• Share — open the share dialog

Troubleshooting

"App pending admin approval"

Enterprise Box accounts require an admin to approve custom apps before they can authenticate. Ask your Box admin to approve the app in the Admin Console.

Files not appearing

Make sure the OAuth scope includes Read all files and folders. Without it, Box only returns files the app itself created.