The Azure Boards integration is currently in Alpha. To have it enabled on your account, contact support@scrums.com.
Overview
The Azure Boards integration connects your work item tracking and sprint management with Scrums.com, enabling seamless analytics and delivery insights. We collect only the metadata required to provide value — never your work item content or attachments. Sensitive data, such as board names and work item titles, are always encrypted.Why integrate Azure Boards?
- Automated analytics — Instantly gain insights into your team’s sprint progress, work item flow, and delivery metrics.
- No code changes needed — Integration is secure and token-based, requiring no changes to your Azure Boards setup.
- Real-time & historical data — See results in minutes, with both real-time and historical analysis.
Permissions
| Scope | Purpose |
|---|---|
| Work Items (Read) | Board metadata, sprints, and work items |
| Project and Team (Read) | Project metadata and team assignments |
| User Profile (Read) | User profiles and assignments |
Requirements
- Admin access to your Azure DevOps organisation and Boards
- Scrums.com workspace Admin access
Setup
Generate an Azure DevOps Personal Access Token
In Azure DevOps, go to User Settings > Personal access tokens and click New Token. Set an expiry as required by your security policy, and select the following scopes:
Work Items (Read)Project and Team (Read)User Profile (Read)
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 Azure Boards
Click Add Integration and select Azure Boards from the list. Choose the project you want to link.
Authorise Scrums.com to access Azure Boards
Enter your Azure DevOps organisation name and paste your personal access token into the integration form. Save the form.
Add projects and boards
Click Add next to Azure Boards projects or boards. Select your organisation, enter the project or board name, and specify the relevant key or ID. 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.
- Token security — Store your Azure DevOps personal access token securely. Do not share it publicly.
- Board selection — Only connect boards and projects relevant to your analytics needs.
What this unlocks
Connecting Azure Boards 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 Azure DevOps account has the required permissions and correct token scopes |
| Data not syncing | Double-check your token permissions and board/project names — the integration page will alert you if a token has expired or a name is invalid |
| Need help? | Contact support through your Scrums.com dashboard |