# Get Users on a Team

Retrieves the complete list of every PagerDuty user who currently belongs to one specifically named team in your account.


> **Availability:** See the [Incident Workflow Actions Overview table](/workflow-actions) for the plans this workflow is available on.

## Description

Retrieve the list of users associated with a specific team.

## Instructions

1. If you have not done so, follow the instructions to [Create an Incident Workflow](/ai-automation/automation/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/ai-automation/automation/incident-workflows#add-actions), select **this action**.
3. Enter the following **Inputs** and click **Save**.
4. Continue following instructions to **Publish** the Workflow.
5. When the action runs, you will see the **Outputs** listed below.

## Inputs

> **Field References:** Fields with the **\{+\}** icon accept [Field References](/ai-automation/automation/incident-workflows#field-references), which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click **\{+\}**, or enter `{{`, and select relevant fields. Refer to the [Field References](/ai-automation/automation/incident-workflows#field-references) article for more information.

| Name    | Description                                                     |
| :------ | :-------------------------------------------------------------- |
| Team ID | The ID of the team to get users for. Defaults to `{{team.id}}`. |

## Outputs

| Name            | Description                                                                         |
| :-------------- | :---------------------------------------------------------------------------------- |
| Number of Users | The number of users associated with the team                                        |
| List of Users   | The JSON array of users associated with the team                                    |
| Result          | Value that shows if the action was successful or not. Either "Success" or "Failed." |
| Result Summary  | Brief description of what the action did or if it failed                            |
| Error           | Brief description that is populated if the action failed                            |

## PagerDuty API Endpoint

Endpoint used:

- [List Members of a Team](/developer/api/reference/rest/teams/list-team-users)