---
title: Azure DevOps
slug: azure-devops
image: https://make-cxp-documentation.ams3.digitaloceanspaces.com/apps-center-icons/PREVIEW_azure-devops.png
docTags:
createdAt: 2025-02-03T13:29:01.216Z
---
With Azure DevOps modules in Make, you can:
- watch work items, git, and code events
- search, create, retrieve, and update work items
- call APIs
To get started with Azure DevOps, create an account at [dev.azure.com](https://dev.azure.com).
Make provides two ways to connect the Azure DevOps app:
- [Azure DevOps](docId\:EqTeZ4TLtl1SL3WGhA38h)
- [Azure DevOps (Azure App OAuth)](docId\:EqTeZ4TLtl1SL3WGhA38h)
:::ExpandableHeading
# Connect Azure DevOps to Make
To establish the connection, you must:
1. Log in to your Azure DevOps account.
2. If you don't have a created organization, click **Create new organization**, enter a name, and click **Create**.
3. In the left sidebar, click **Organization settings** > **Policies**.
4. Enable the option **Third-party application access via OAuth**.
5. Copy the **organization name** located under the **Organization Settings**.
6. Log in to your Make account, add a Azure DevOps module to your scenario, and click **Create a connection**.
7. Optional: In the **Connection name** field, enter a name for the connection.
8. In the **Organization** field, enter the **organization name** copied above.
9. Optional: Click **Show advanced settings** and enter your custom app client credentials. For more information, refer to the [Azure DevOps OAuth 2.0](https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/azure-devops-oauth?view=azure-devops).
10. Click **Save**.
11. If prompted, authenticate your account and confirm access.
You have successfully established the connection. You can now edit your scenario and add more Azure DevOps modules. If your connection requires reauthorization at any point, follow the connection renewal steps [here](docId\:SO88FM6pkT0G-adKDDfzZ).
:::
::::ExpandableHeading
# Connect Azure DevOps to Make with Azure App OAuth
To establish the connection, you must:
:::hint{type="info"}
Selecting too many scopes will result in a Requested query string is too long error.
:::
1. Log in to your Azure DevOps account.
2. If you don't have a created organization, click **Create new organization**, enter a name, and click **Create**.
3. In the left sidebar, click **Organization settings** > **Policies**.
4. Enable the option **Third-party application access via OAuth**.
5. Copy the **organization name** located under the **Organization Settings**.
6. Log in to your Make account, add a Azure DevOps module to your scenario, and click **Create a connection**.
7. Optional: In the **Connection name** field, enter a name for the connection.
8. In the **Organization** field, enter the **organization name** copied above.
9. In the **Scopes** field, add the additional scopes to your connection as needed. For more information about the scopes, refer to the [Azure DevOps OAuth 2.0 documentation](https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/oauth?view=azure-devops#scopes).
10. Optional: Click **Show advanced settings** and enter your custom app client credentials. For more information, refer to the [Azure DevOps OAuth 2.0](https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/service-principal-managed-identity?view=azure-devops).
11. Click **Save**.
12. If prompted, authenticate your account and confirm access.
You have successfully established the connection. You can now edit your scenario and add more Azure DevOps modules. If your connection requires reauthorization at any point, follow the connection renewal steps [here](#).
::::
# Azure DevOps modules
## Triggers
You can watch work items, gists, and event code using the following modules.
### Watch Work Items Events
Triggers when an event for work item happens.
| **Field** | **Description** |
| ---------------- | --------------------------------------------------- |
| **Webhook Name** | Enter a name for the webhook. |
| **Connection** | Establish a connection to your Azure DevOpsaccount. |
| **Event Type** | Select the event type you want to watch. |
### Watch Git Events
Triggers when an event for git happens.
| **Field** | **Description** |
| ---------------- | --------------------------------------------------- |
| **Webhook Name** | Enter a name for the webhook. |
| **Connection** | Establish a connection to your Azure DevOpsaccount. |
| **Event Type** | Select the event type you want to watch. |
### Watch Code Events
Triggers when an event for code happens.
| **Field** | **Description** |
| ---------------- | --------------------------------------------------- |
| **Webhook Name** | Enter a name for the webhook. |
| **Connection** | Establish a connection to your Azure DevOpsaccount. |
| **Event Type** | Select the event type you want to watch. |
## Work Items
You can search, create, update, and retrieve work items using the following module.
### Search Work Items
Searches work items by type or returns them all.
| **Field** | **Description** |
| -------------- | ------------------------------------------------------------------------------------ |
| **Connection** | [Establish a connection to your Azure DevOps account.](docId\:EqTeZ4TLtl1SL3WGhA38h) |
| **Project** | Select or map the project whose work items you want to search. |
| **Team** | Select or map the team whose work items you want to search. |
| **Item Type** | Select or map the item type whose work items you want to search. |
| **Limit** | Set the maximum number of work items Make will return during one execution cycle. |
### Create a Work Item
Creates a new work item.
| **Field** | **Description** |
| -------------- | ------------------------------------------------------------------------------------------ |
| **Connection** | [Establish a connection to your Azure DevOps account.](docId\:EqTeZ4TLtl1SL3WGhA38h) |
| **Project** | Select or map the project in which you want to create the work item and enter the details. |
| **Item Type** | Select or map the item type and enter its information to create the work item. |
### Get a Work Item
Retrieves details about a specific work item.
| **Field** | **Description** |
| ---------------- | ------------------------------------------------------------------------------------ |
| **Connection** | [Establish a connection to your Azure DevOps account.](docId\:EqTeZ4TLtl1SL3WGhA38h) |
| **Project** | Select or map the project's work item details you want to retrieve. |
| **Work Item ID** | Click Search ID and select the work item whose details you want to retrieve. |
### Update a Work Item
Updates a specific work item.
| **Field** | **Description** |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Connection** | [Establish a connection to your Azure DevOps account.](docId\:EqTeZ4TLtl1SL3WGhA38h) |
| **Project** | Select or map the project whose work item details you want to update. |
| **Item Type** | Select or map the item type whose details you want to update. |
| **Work Item ID** | Click Search ID and select the work item whose details you want to update.
Enter the details to update the work item. |
## Other
### Make an API Call
Performs an arbitrary authorized API call.
| **Field** | **Description** |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connection** | [Establish a connection to your Azure DevOps account.](docId\:EqTeZ4TLtl1SL3WGhA38h) |
| **URL** | Enter a path relative to `https://dev.azure.com/{organization}`.
For example, `/api/projects`. |
| **Method** | Select the HTTP method you want to use:
**GET**: to retrieve information for an entry.
**POST**: to create a new entry.
**PUT**: to update/replace an existing entry.
**PATCH**: to make a partial entry update.
**DELETE**: to delete an entry. |
| **Headers** | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
| **Query String** | Enter the request query string. |
| **Body** | Enter the body content for your API call. |
Refer to the [Azure DevOps API documentation](https://docs.microsoft.com/en-us/rest/api/azure/devops/) for more information.