---
title: "List Teams integration mappings"
method: GET
path: "/integration_mappings/teams"
tags: ["Integration mappings"]
---

# List Teams integration mappings

`GET /integration_mappings/teams`

Lists [Teams integration mappings](https://support.box.com/hc/en-us/articles/360044681474-Using-Box-for-Teams) in a users' enterprise.
You need Admin or Co-Admin role to
use this endpoint.

## Query parameters

- `partner_item_type` 'channel' | 'team'
- `partner_item_id` string
- `box_item_id` string
- `box_item_type` 'folder'

## Response `200`

Returns a collection of integration mappings.

- IntegrationMappingsTeams — A list of integration mapping objects.
  - `entries` IntegrationMappingTeams[] — A list of integration mappings.
    - `id` string, required — A unique identifier of a folder mapping (part of a composite key together with `integration_type`).
    - `type` 'integration_mapping', required — Mapping type.
    - `integration_type` 'teams' — Identifies the Box partner app, with which the mapping is associated. Supports Slack and Teams. (part of the composite key together with `id`).
    - `is_overridden_by_manual_mapping` boolean — Identifies whether the mapping has been manually set by the team owner from UI for channels (as opposed to being automatically created).
    - `partner_item` IntegrationMappingPartnerItemTeams, required — The schema for an integration mapping mapped item object for type Teams.
      - `type` 'channel' | 'team', required — Type of the mapped item referenced in `id`.
      - `id` string, required — ID of the mapped item (of type referenced in `type`).
      - `tenant_id` string, required — ID of the tenant that is registered with Microsoft Teams.
    - `box_item` object, required — The Box folder, to which the object from the partner app domain (referenced in `partner_item_id`) is mapped.
      - `type` 'folder', required — The value will always be `folder`.
      - `id` string, required — ID of the folder.
    - `created_at` string, date-time — When the integration mapping object was created.
    - `modified_at` string, date-time — When the integration mapping object was last modified.

## Other responses

- `400` — The server cannot or will not process the request due to an apparent client error.
- `404` — Returns a `not_found` error if the integration mapping could not be found.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)