Overview
The ClickUp integration connects your project management and task workflows with Scrums.com, enabling seamless analytics and delivery insights. We collect only the metadata required to provide value — never your task content or attachments. Sensitive data, such as list names and task titles, are always encrypted.Why integrate ClickUp?
- Automated analytics — Instantly gain insights into your team’s project progress, resource allocation, and delivery metrics.
- No code changes needed — Integration is secure and token-based, requiring no changes to your ClickUp workspace.
- Real-time & historical data — See results in minutes, with both real-time and historical analysis.
Permissions
| Scope | Purpose |
|---|---|
| Spaces, Folders, Lists | Read access to workspace structure and metadata |
| Tasks | Read access to task metadata, statuses, and assignments |
| Users | Read access to user profiles and assignments |
Requirements
- ClickUp account with API access
- Scrums.com workspace Admin access
Setup
Log in to Scrums.com
Go to Scrums.com and sign in to your account.
Navigate to Integrations
In your dashboard, click on your profile or account menu and select Integrations from the dropdown or sidebar.
Add ClickUp
Click Add Integration and select ClickUp from the list. Choose the project you want to link.
Authorise Scrums.com to access ClickUp
Enter your ClickUp API key (found in your personal ClickUp settings under My Settings > Apps). Click the green checkbox to save.
Add your ClickUp Sprint Folder
Click Add to add your ClickUp sprint folder. Select the ClickUp workspace and add the relevant Folder ID for the project sprints. Click Verify to check the connection.
Best practices
- Use a long-term admin account — Set up the integration with an account that will remain active to avoid disruptions.
- API key security — Store your ClickUp API key securely. Do not share it publicly.
- Workspace selection — Only connect sprint folders relevant to your analytics needs.
What this unlocks
Connecting ClickUp to Scrums.com gives your team:- Transparency and accountability across teams
- Data-driven retrospectives and planning sessions
- Real-time delivery metrics to identify bottlenecks and celebrate wins
- A culture of continuous improvement with actionable insights
Troubleshooting
| Issue | Resolution |
|---|---|
| Authorization error | Ensure your ClickUp account has the required permissions and a valid API key |
| Data not syncing | Double-check your API key permissions and workspace/folder IDs — the integration page will alert you if a key has expired or an ID is invalid |
| Need help? | Contact support through your Scrums.com dashboard |