---
title: List Azure App Services
source: https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/azure/azure-appservice-list
---

Lists Azure App Service web applications in a resource group. Returns paginated results — if the resource group contains enough apps to span multiple pages, a `nextLink` field is included in the response for retrieving the next page.

For authentication setup, see [Azure App Service actions](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/azure/azure-appservice).

## Inputs

| Input               | Type    | Description                                                                                                                                                                                                                                                        |
| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `clientId`          | String  | **Required.** An Azure service-principal client ID. See how to [register an Azure app](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/api/register-app-for-token). Must be passed as a secret.                                                         |
| `clientSecret`      | String  | **Required.** An Azure service-principal client secret. See how to [register an Azure app](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/api/register-app-for-token). Must be passed as a secret.                                                     |
| `tenantId`          | String  | **Required.** The Azure tenant identifier. Can be passed as a secret.                                                                                                                                                                                              |
| `subscriptionId`    | String  | **Required.** The Azure subscription identifier. For example, `"12345678-1234-1234-1234-123456789abc"`.                                                                                                                                                            |
| `resourceGroupName` | String  | **Required.** The name of the resource group to list App Services from. For example, `"my-resource-group"`.                                                                                                                                                        |
| `includeSlots`      | Boolean | **Optional.** If `true`, includes deployment slots in the results. Default: `false`. **Note:** slot entries are named `appName/slotName` and cannot be passed as `appServiceName` to `azure.appService.get`, `azure.appService.start`, or `azure.appService.stop`. |
| `selectors`         | List    | **Optional.** JQ selectors to extract specific values from the response. For example, `[{"name": "appNames", "expression": "[.response.value[].name]"}]`.                                                                                                          |

## Outputs

| Output              | Type    | Description                                                                                                                                                                                                                                                                      |
| ------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `success`           | Boolean | Indicates whether the action succeeded. Returns `true` or `false`.                                                                                                                                                                                                               |
| `errorMessage`      | String  | Contains the failure reason as a message.                                                                                                                                                                                                                                        |
| `response`          | Object  | The Azure API response body, containing a `value` array of App Service objects and an optional `nextLink` field for pagination. For full schema, see [Web Apps - List By Resource Group](https://learn.microsoft.com/en-us/rest/api/appservice/web-apps/list-by-resource-group). |
| `asyncResponseUrl`  | String  | Optional for long-running operations. The URL to poll for status.                                                                                                                                                                                                                |
| `finalResponseUrl`  | String  | Optional for long-running operations. The URL that returns the final result once the operation completes.                                                                                                                                                                        |
| `retryAfterSeconds` | Integer | Optional for long-running operations. The number of seconds to wait before polling the async URL.                                                                                                                                                                                |
| `eTag`              | String  | **Optional.** Used for concurrency control when updating a resource.                                                                                                                                                                                                             |

If the response includes a `nextLink` field, there are additional pages of results. Capture it with a selector and call `azure.execute.api` directly with that URL as `urlPath` to retrieve the next page.

## Example

```yaml
name: listAzureAppServices
description: List Azure App Services in a resource group
steps:
  - name: list_app_services
    type: action
    action: azure.appService.list
    version: 1
    inputs:
      clientId: ${{ :secrets:azure-client-id }}
      clientSecret: ${{ :secrets:azure-client-secret }}
      tenantId: ${{ :secrets:azure-client-tenant }}
      subscriptionId: "12345678-1234-1234-1234-123456789abc"
      resourceGroupName: "my-resource-group"
      selectors:
        - name: appNames
          expression: "[.response.value[].name]"
        - name: nextLink
          expression: ".response.nextLink // \"\""
    next: end
```