Understanding Tool Permissions
For workers to use a tool they need two things:- To have the tool (think of it like installing a tool on the computer)
- An account connected to the tool
Want to understand how this two-level system works in detail? Check out our Tool Permissions guide.
Want to see all available tools? Browse our complete Tools & Integrations directory.
Setting Up Your Tools
1
Connect accounts at the user level
Navigate to Settings → Toolbox in your Spinnable dashboard. This is where you connect your account’s tools and services to Spinnable.Click Connect next to any tool you want to make available. You’ll authenticate with the service and grant Spinnable the necessary permissions.This step makes tools available to your workers — but doesn’t give them access yet.
2
Enable tools for specific workers
Go to the worker’s profile and open the Tools tab. You’ll see all the tools you’ve connected at the account level.Toggle on the tools this specific worker should be able to use. Different workers can have access to different tools based on their role.
3
Test the connection
Ask your worker to perform a simple task using the tool. For example: “Can you check my calendar for tomorrow?” or “Send a test email to myself.”This confirms the worker has the access they need and knows how to use the tool.
Best Practices
Connect tools before assigning to workers
Connect tools before assigning to workers
Always add tools to your account-level Toolbox before configuring worker access. This ensures smooth setup and prevents workers from requesting tools mid-task.Why this matters: If a worker needs a tool that isn’t connected, they’ll have to ask you to add it, interrupting their workflow.
Start with essential tools only
Start with essential tools only
Begin by connecting only the tools your workers need immediately. You can always add more later as requirements evolve.Recommended starting tools:
- Email (Gmail or Outlook) for communication
- Calendar for scheduling
- One productivity tool (Slack, Notion, or Google Drive)
Grant permissions based on worker roles
Grant permissions based on worker roles
Match tool access to each worker’s specific responsibilities rather than giving everyone access to everything.Example:
- Marketing worker: Email, social media tools, analytics
- Operations worker: Calendar, project management, spreadsheets
- Technical worker: Code repositories, documentation tools
Review tool permissions regularly
Review tool permissions regularly
As your workers’ responsibilities evolve, audit their tool access monthly to ensure:
- They have access to everything they need
- They’re not cluttered with unnecessary tools
- Permissions align with current tasks
Test tool connections after setup
Test tool connections after setup
After connecting a tool and granting worker access, verify it works by:
- Asking the worker to perform a simple task with the tool
- Checking that the worker can both read and write (if applicable)
- Confirming any automated workflows trigger correctly
Troubleshooting
Worker can't access a tool I connected
Worker can't access a tool I connected
Most common cause: The tool is connected to your account but not granted to that specific worker.Solution:
- Go to Workers → Select the worker
- Click Tools tab
- Enable the tool for that worker
- Save changes
Remember: Connecting a tool to your account-level Toolbox doesn’t automatically give workers access. You must explicitly grant it per worker.
Tool connection keeps failing
Tool connection keeps failing
Common causes and solutions:
- Authentication expired: Re-authorize the tool in Settings → Toolbox
- Insufficient permissions: Check that you granted all required permissions during OAuth
- Third-party restrictions: Some organizations block third-party app access — contact your IT admin
- Go to Settings → Toolbox
- Click disconnect next to the tool
- Follow the connection steps again
Worker using tool incorrectly
Worker using tool incorrectly
Workers learn and adapt through conversational feedback, just like human employees.Solution approach:
- Give clear, specific feedback: “When sending emails, please keep them to 3-4 bullet points”
- The worker will memorize this preference and adjust behavior
- You can review what they’ve learned in Workers → Knowledge section
Need to revoke tool access
Need to revoke tool access
To remove a worker’s access to a tool:
- Go to Workers → Select the worker
- Click Tools tab
- Toggle off the tool you want to revoke
- Confirm the change
Tool connection shows but doesn't work
Tool connection shows but doesn't work
Diagnostic steps:
- Check tool status: Go to Settings → Toolbox — look for warning icons
- Verify API limits: Some tools have rate limits that may be exceeded
- Review permissions: Ensure the connected account has necessary privileges
- Test manually: Try using the tool yourself to confirm it’s operational
Next Steps
Configure Worker Access
Learn how to grant and manage tool permissions for individual workers
Tool Permissions Guide
Understand the two-level permission system and common access patterns
Managing Workers
Explore best practices for organizing and scaling your AI workforce
Providing Feedback
Master conversational feedback to improve worker performance