Overview
Start automations when files change inside OneDrive. You can generate audit summaries, notify security teams about external sharing, or update downstream line-of-business systems with new document metadata.Connect OneDrive in Tools & Integrations and toggle the trigger on for your deployment.
Enabling the OneDrive Trigger
- Open your deployment in CrewAI AMP
- Go to the Triggers tab
- Locate OneDrive and switch the toggle to enable

Microsoft OneDrive trigger connection
Example: Audit file permissions
Testing Locally
Test your OneDrive trigger integration locally using the CrewAI CLI:crewai triggers run
command will execute your crew with a complete OneDrive payload, allowing you to test your parsing logic before deployment.
Use
crewai triggers run microsoft_onedrive/file_changed
(not crewai run
) to simulate trigger execution during development. After deployment, your crew will automatically receive the trigger payload.Troubleshooting
- Ensure the connected account has permission to read the file metadata included in the webhook
- Test locally with
crewai triggers run microsoft_onedrive/file_changed
to see the exact payload structure - If the trigger fires but the payload is missing
permissions
, confirm the site-level sharing settings allow Graph to return this field - For large tenants, filter notifications upstream so the crew only runs on relevant directories
- Remember: use
crewai triggers run
(notcrewai run
) to simulate trigger execution