Teamwork Setup
Create a Teamwork OAuth app to manage projects, tasks, milestones, and time tracking through Fp Switchboard.
Prerequisites
Section titled “Prerequisites”- Teamwork account (any plan)
- Access to Teamwork Developer Portal
Setup Steps
Section titled “Setup Steps”-
Access Developer Portal
Go to Teamwork Developer Portal and sign in.
-
Create New App
Create a new app with “App Login” authentication type.
-
Configure App
- App name: Fp Switchboard
- Authentication: App Login (OAuth)
-
Add Redirect URI
https://api.switchboard.fpdigital.ai/oauth/teamwork/callback -
Copy Credentials
Copy the Client ID and Client Secret.
Environment Variables
Section titled “Environment Variables”npx wrangler secret put TEAMWORK_CLIENT_IDnpx wrangler secret put TEAMWORK_CLIENT_SECRETRedirect URI
Section titled “Redirect URI”https://api.switchboard.fpdigital.ai/oauth/teamwork/callbackImportant Notes
Section titled “Important Notes”Common Issues
Section titled “Common Issues”- Site URL required: Teamwork APIs are site-specific. The site URL is captured during OAuth and stored automatically.
- Project permissions: Users can only access projects they have been added to in Teamwork.
- Time tracking: Time log operations require the Time Tracking feature to be enabled in your Teamwork plan.
Testing
Section titled “Testing”- Connect from the Switchboard Dashboard
- Authorize with your Teamwork account
- Click Test Connection to verify
- Try: “List my Teamwork projects” or “Show my tasks for this week”