n8n-nodes-azuredevops-advanced

A comprehensive n8n community node package for Azure DevOps integration. Manage Git, Pipelines, Work Items, Pull Requests, Test Plans, Boards, Wiki, Service Hooks, TFVC, and Artifacts — all from a single node.

Table of Contents

• Features
• Installation
• Credential Configuration
• Resources & Operations
  • Git Repositories
  • Pipeline (CI/CD)
  • Work Items
  • Pull Requests
  • Test Plans
  • Boards
  • Wiki
  • Service Hooks
  • TFVC
  • Artifacts
• Usage Examples
• Requirements
• Contributing
• License

Features

• 10 Azure DevOps resources managed through a single node
• 40+ operations for comprehensive automation
• Azure DevOps REST API v7.1 support
• Secure authentication via Personal Access Token (PAT)
• Full support for n8n error handling and continueOnFail
• Built with TypeScript for complete type safety

Supported Resources

| Resource | Operations | Description | |----------|-----------|-------------| | Git Repositories | 4 | List repos, read files, create branches, push commits | | Pipeline (CI/CD) | 4 | List, run, get logs, cancel pipelines | | Work Items | 6 | Create, update, list work items; manage users and tags | | Pull Requests | 5 | Create, update, list PRs, read comments | | Test Plans | 4 | List test plans, suites, cases, and runs | | Boards | 3 | List boards, columns, and iterations (sprints) | | Wiki | 4 | Read, create, and update wiki pages | | Service Hooks | 2 | List and create webhook subscriptions | | TFVC | 2 | List TFVC branches and read files | | Artifacts | 2 | List feeds and packages |

Installation

Via n8n UI (Recommended)

1. In n8n, go to Settings → Community Nodes
2. Click Install
3. Enter the package name: n8n-nodes-azuredevops-advanced
4. Click Install and confirm the restart

Manual Installation via npm

For self-hosted n8n environments:

npm install n8n-nodes-azuredevops-advanced

If you're running Docker, add it to the n8n-custom-extensions folder or build a custom Docker image:

FROM n8nio/n8n
RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-azuredevops-advanced

Credential Configuration

Creating an Azure DevOps Personal Access Token (PAT)

1. Go to dev.azure.com and sign in
2. Click your user icon in the top right → Personal access tokens
3. Click New Token
4. Give the token a name (e.g. n8n-integration)
5. Set an Expiration date
6. Under Scopes, select the permissions you need:

| Scope | Permission | Used For | |-------|-----------|----------| | Code | Read & Write | Git, Pull Requests | | Build | Read & Execute | Pipeline | | Work Items | Read & Write | Work Items, Boards | | Test Management | Read & Write | Test Plans | | Wiki | Read & Write | Wiki | | Service Hooks | Read, Write & Manage | Service Hooks | | Packaging | Read | Artifacts |

7. Click Create and copy the token (it won't be shown again!)

Creating a Credential in n8n

1. In n8n, go to Credentials → Add Credential
2. Select Azure DevOps Advanced API
3. Fill in the following fields:

| Field | Description | Example | |-------|-------------|---------| | Organization | Your Azure DevOps organization name | mycompany | | Personal Access Token | The PAT you created above | xxxxxxxxxxxxxxxxxxxx |

4. Click Save

Note: You can find your organization name in the URL: dev.azure.com/{organization}

Resources & Operations

1. Git Repositories

Manage Azure DevOps Git repositories.

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | List Repositories | List all Git repos in a project | Project | | Get File Content | Retrieve the content of a file | Project, Repository ID, File Path | | Create Branch | Create a new branch (from main) | Project, Repository ID, Branch Name | | Push Commit | Commit a file change | Project, Repository ID, Branch Name, Commit Message |

Example: Get File Content

Resource: Git Repositories
Operation: Get File Content
Project: MyProject
Repository ID: my-repo
File Path: /src/app.ts

Example: Create Branch

Resource: Git Repositories
Operation: Create Branch
Project: MyProject
Repository ID: my-repo
Branch Name: refs/heads/feature/new-feature

2. Pipeline (CI/CD)

Automate Azure DevOps build and release pipelines.

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | List Pipelines | List all pipelines | Project | | Run Pipeline | Trigger a pipeline | Project, Pipeline ID | | Get Build Logs | Retrieve logs for a specific run | Project, Pipeline ID, Run ID | | Cancel Run | Cancel an active pipeline run | Project, Pipeline ID, Run ID |

Example: Trigger a Pipeline

Resource: Pipeline
Operation: Run Pipeline
Project: MyProject
Pipeline ID: 42

Example: Get Build Logs

Resource: Pipeline
Operation: Get Build Logs
Project: MyProject
Pipeline ID: 42
Run ID: 1234

3. Work Items

Manage Azure DevOps work items (Task, Bug, Epic, Feature, User Story).

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | Get Work Item | Fetch a single work item | Project, Work Item ID | | List All Work Items | List all work items via WIQL query | Project | | Create Work Item | Create a new work item | Project, Work Item Type, Title | | Update Work Item | Update an existing work item | Project, Work Item ID | | List Users | List organization users | — | | List Tags | List all tags in a project | Project |

Supported Work Item Types

• Task
• Bug
• Epic
• Feature
• User Story
• Issue
• Test Case

Supported Work Item States

• New / To Do
• Active / Doing
• Resolved
• Closed / Done
• Removed

Additional Fields (Optional)

Extra fields available when creating or updating a work item:

| Field Name | Description | |-----------|-------------| | System.Description | Work item description (HTML supported) | | System.AssignedTo | Assigned user name or email | | System.State | State (New, Active, Resolved, Closed) | | Microsoft.VSTS.Common.Priority | Priority (1=Highest, 4=Lowest) | | System.Tags | Tags (semicolon-separated) | | Custom.FieldName | Any custom field |

Example: Create a Bug

Resource: Work Items
Operation: Create Work Item
Project: MyProject
Work Item Type: Bug
Title: Login button not working
Additional Fields:
  - System.Description: Steps to reproduce...
  - System.AssignedTo: [email protected]
  - Microsoft.VSTS.Common.Priority: 1

4. Pull Requests

Automate Git pull request workflows.

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | Get Pull Request | Fetch a single PR | Project, Repository ID, PR ID | | List Pull Requests | List PRs with filters | Project, Repository ID | | Create Pull Request | Open a new PR | Project, Repository ID, Source Branch, Target Branch, Title | | Update Pull Request | Update or merge a PR | Project, Repository ID, PR ID | | Get Comments | Fetch PR review threads | Project, Repository ID, PR ID |

PR Listing Filters

| Filter | Options | |--------|---------| | Status | active, abandoned, completed, all | | Source Branch | Source branch name | | Target Branch | Target branch name | | Limit | Maximum number of results |

Merge Strategies

Merge strategies available when completing a PR:

| Strategy | Description | |----------|-------------| | noFastForward | Create a merge commit | | rebase | Rebase onto target branch | | rebaseMerge | Rebase and create a merge commit | | squash | Squash all commits into one |

Example: Create a Pull Request

Resource: Pull Requests
Operation: Create Pull Request
Project: MyProject
Repository ID: my-repo
Source Branch: refs/heads/feature/new-feature
Target Branch: refs/heads/main
Title: Add new authentication feature
Additional Fields:
  - Description: This PR adds OAuth2 support
  - isDraft: false
  - Reviewers: user-id-1,user-id-2

5. Test Plans

Automate Azure DevOps test management.

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | List Test Plans | List all test plans | Project | | List Test Suites | List suites within a plan | Project, Plan ID | | List Test Cases | List test cases within a suite | Project, Plan ID, Suite ID | | List Test Runs | List all test runs | Project |

Example: List Test Cases

Resource: Test Plans
Operation: List Test Cases
Project: MyProject
Plan ID: 10
Suite ID: 25

6. Boards

Agile board and sprint management.

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | List Boards | List team boards | Project, Team | | List Board Columns | List columns in a board | Project, Team, Board ID | | List Iterations | Get sprint/iteration list | Project, Team |

Example: Get Sprint List

Resource: Boards
Operation: List Iterations
Project: MyProject
Team: MyProject Team

Common Board IDs

• Epics
• Features
• Stories
• Backlog items

7. Wiki

Manage Azure DevOps wiki pages.

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | List Wikis | List all wikis in a project | Project | | Get Page | Fetch a wiki page | Project, Wiki Identifier, Page Path | | Create Page | Create a new wiki page | Project, Wiki Identifier, Page Path, Content | | Update Page | Update an existing wiki page | Project, Wiki Identifier, Page Path, Content |

Example: Create a Wiki Page

Resource: Wiki
Operation: Create Page
Project: MyProject
Wiki Identifier: MyProject.wiki
Page Path: /Documentation/API-Guide
Content: # API Guide\n\nThis page contains the API reference...

Note: The Content field supports Markdown format.

8. Service Hooks

Manage webhook subscriptions for Azure DevOps events.

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | List Subscriptions | List all webhook subscriptions | — | | Create Subscription | Create a new webhook subscription | Project, Event Type, Consumer URL |

Supported Event Types

| Event Type | Description | |-----------|-------------| | build.complete | Build completed | | git.push | Code pushed | | git.pullrequest.created | Pull request created | | git.pullrequest.merged | Pull request merged | | workitem.created | Work item created | | workitem.updated | Work item updated | | ms.vss-release.release-created-event | Release created |

Example: Create a Webhook Subscription

Resource: Service Hooks
Operation: Create Subscription
Project: MyProject
Event Type: git.push
Consumer URL: https://your-n8n-instance.com/webhook/xyz

Tip: Use your n8n Webhook node's URL as the Consumer URL to connect Azure DevOps events directly to n8n workflows.

9. TFVC

Support for Team Foundation Version Control (legacy source control).

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | List Branches | List TFVC branches and folders | Project | | Get File Content | Read a file from TFVC | Project, File Path |

Example: Read a TFVC File

Resource: TFVC
Operation: Get File Content
Project: MyProject
File Path: $/MyProject/src/main.cs

Note: TFVC paths start with $/.

10. Artifacts

Azure Artifacts package feed management.

Operations

| Operation | Description | Required Parameters | |-----------|-------------|-------------------| | List Feeds | List all artifact feeds | Project | | List Packages | List packages in a feed | Project, Feed ID |

Example: List Packages

Resource: Artifacts
Operation: List Packages
Project: MyProject
Feed ID: my-nuget-feed

Usage Examples

Example 1: Automated PR Creation Workflow

This workflow automatically creates a PR in Azure DevOps in response to an external event:

1. Webhook Trigger → Receives a GitHub push event
2. Azure DevOps Advanced (Git: Create Branch) → Creates a new branch
3. Azure DevOps Advanced (Pull Requests: Create) → Opens a PR
4. Slack → Sends a notification to the team

Example 2: Work Item Automation

Synchronize issues from Jira to Azure DevOps:

1. Schedule Trigger → Runs every hour
2. Jira → Lists new issues
3. IF → Filters out items already in Azure DevOps
4. Azure DevOps Advanced (Work Items: Create) → Creates a Task
5. Jira → Updates the original issue

Example 3: Build Monitoring

Send an alert when a pipeline fails:

1. Azure DevOps Advanced (Service Hooks: Create Subscription) → Subscribes to build events
2. Webhook → Receives the build complete event
3. IF → Checks whether the build failed
4. Azure DevOps Advanced (Pipeline: Get Build Logs) → Fetches error logs
5. Email / Slack → Sends a detailed failure notification

Requirements

• n8n >= 1.0.0
• Node.js >= 18.x
• An Azure DevOps account and organization
• A Personal Access Token (PAT) with sufficient permissions

Development

To run the project locally:

# Clone the repository
git clone https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced.git
cd n8n-nodes-azuredevops-advanced

# Install dependencies
npm install

# TypeScript compilation (watch mode)
npm run dev

# Production build
npm run build

Project Structure

n8n-nodes-azuredevops-advanced/
├── nodes/
│   └── AzureDevOpsAdvanced/
│       ├── AzureDevOpsAdvanced.node.ts    # Main node implementation
│       ├── GenericFunctions.ts            # API request helper
│       ├── azureDevOps.svg               # Node icon
│       └── descriptions/
│           ├── GitDescription.ts
│           ├── PipelineDescription.ts
│           ├── WorkItemDescription.ts
│           ├── PullRequestDescription.ts
│           ├── TestPlanDescription.ts
│           ├── BoardDescription.ts
│           ├── WikiDescription.ts
│           ├── ServiceHookDescription.ts
│           ├── TfvcDescription.ts
│           └── ArtifactsDescription.ts
├── credentials/
│   └── AzureDevOpsAdvancedApi.credentials.ts
├── dist/                                  # Compiled JavaScript
├── package.json
└── tsconfig.json

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Bug Reports

You can report bugs or request features via GitHub Issues.

License

This project is licensed under the MIT License.

Links

• npm Package
• GitHub Repository
• Azure DevOps REST API Documentation
• n8n Community Nodes Guide