> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom: Retrieve Team

> Get an Intercom team by its ID, with its admins. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Get an Intercom team by its ID, with its admins.

> [!NOTE]
>
> Tool ID: `intercom_retrieve_team`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'intercom_retrieve_team',
  {
    "team_id": "team_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute intercom_retrieve_team --input '{
  "team_id": "team_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "type": "example",
    "id": "id_123",
    "name": "Example"
  }
}
```

Use `deepline describe intercom_retrieve_team --json` for the latest machine-readable contract.

## Input reference

You can fetch the details of a single team, containing an array of admins that belong to this team.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.team_id` | `string` | Yes | — | The unique identifier of a given team. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "You can fetch the details of a single team, containing an array of admins that belong to this team.",
    "properties": {
      "team_id": {
        "type": "string",
        "description": "The unique identifier of a given team."
      }
    },
    "required": [
      "team_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Teams are groups of admins in Intercom. |
| `result.data.type` | `string` | No | — | Value is always "team" |
| `result.data.id` | `string` | No | — | The id of the team |
| `result.data.name` | `string` | No | — | The name of the team |
| `result.data.admin_ids` | `array` | No | — | The list of admin IDs that are a part of the team. |
| `result.data.admin_priority_level` | `object \| null` | No | — | Admin priority levels for the team |
| `result.data.admin_priority_level.primary_admin_ids` | `array \| null` | No | — | The primary admin ids for the team |
| `result.data.admin_priority_level.secondary_admin_ids` | `array \| null` | No | — | The secondary admin ids for the team |
| `result.data.assignment_limit` | `integer \| null` | No | — | The assignment limit for the team. This field is only present when the team's distribution type is load balanced. |
| `result.data.distribution_method` | `string \| null` | No | — | Describes how assignments are distributed among the team members |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Teams are groups of admins in Intercom.",
        "properties": {
          "type": {
            "type": "string",
            "description": "Value is always \"team\""
          },
          "id": {
            "type": "string",
            "description": "The id of the team"
          },
          "name": {
            "type": "string",
            "description": "The name of the team"
          },
          "admin_ids": {
            "type": "array",
            "description": "The list of admin IDs that are a part of the team.",
            "items": {
              "type": "integer"
            }
          },
          "admin_priority_level": {
            "type": [
              "object",
              "null"
            ],
            "description": "Admin priority levels for the team",
            "properties": {
              "primary_admin_ids": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "The primary admin ids for the team",
                "items": {
                  "type": "integer"
                }
              },
              "secondary_admin_ids": {
                "type": [
                  "array",
                  "null"
                ],
                "description": "The secondary admin ids for the team",
                "items": {
                  "type": "integer"
                }
              }
            },
            "additionalProperties": false
          },
          "assignment_limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The assignment limit for the team. This field is only present when the team's distribution type is load balanced."
          },
          "distribution_method": {
            "type": [
              "string",
              "null"
            ],
            "description": "Describes how assignments are distributed among the team members"
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Intercom provider guide](https://deepline.com/docs/providers/intercom/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.