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

# List Slack integration mappings

`GET /integration_mappings/slack`

Lists [Slack integration mappings](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack) in a users' enterprise.

You need Admin or Co-Admin role to
use this endpoint.

## Query parameters

- `marker` string
- `limit` integer
- `partner_item_type` 'channel'
- `partner_item_id` string
- `box_item_id` string
- `box_item_type` 'folder'
- `is_manually_created` boolean

## Response `200`

Returns a collection of integration mappings.

- IntegrationMappings — The part of an API response that describes marker based pagination.
  - `limit` integer — The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.
  - `next_marker` string, nullable — The marker for the start of the next page of results.
  - `entries` IntegrationMapping[] — 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` 'slack' — Identifies the Box partner app, with which the mapping is associated. Currently only supports Slack. (part of the composite key together with `id`).
    - `is_manually_created` boolean — Identifies whether the mapping has been manually set (as opposed to being automatically created).
    - `options` IntegrationMappingSlackOptions — The schema for an integration mapping options object for Slack type.
      - `is_access_management_disabled` boolean — Indicates whether or not channel member access to the underlying box item should be automatically managed. Depending on type of channel, access is managed through creating collaborations or shared links.
    - `created_by` UserIntegrationMappings — A mini representation of a user, used when nested within another resource.
      - `id` string, required — The unique identifier for this user.
      - `type` 'user', required — The value will always be `user`.
      - `name` string — The display name of this user.
      - `login` string, email — The primary email address of this user.
    - `modified_by` UserIntegrationMappings — A mini representation of a user, used when nested within another resource.
      - `id` string, required — The unique identifier for this user.
      - `type` 'user', required — The value will always be `user`.
      - `name` string — The display name of this user.
      - `login` string, email — The primary email address of this user.
    - `partner_item` IntegrationMappingPartnerItemSlack, required — The schema for an integration mapping mapped item object for type Slack. Depending if Box for Slack is installed at the org or workspace level, provide **either** `slack_org_id` **or** `slack_workspace_id`. Do not use both parameters at the same time.
      - `type` 'channel', required — Type of the mapped item referenced in `id`.
      - `id` string, required — ID of the mapped item (of type referenced in `type`).
      - `slack_workspace_id` string, nullable — ID of the Slack workspace with which the item is associated. Use this parameter if Box for Slack is installed at a workspace level. Do not use `slack_org_id` at the same time.
      - `slack_org_id` string, nullable — ID of the Slack org with which the item is associated. Use this parameter if Box for Slack is installed at the org level. Do not use `slack_workspace_id` at the same time.
    - `box_item` FolderMini, required — The bare basic representation of a folder, the minimal amount of fields returned when using the `fields` query parameter.
      - `id` string, required — The unique identifier that represent a folder. The ID for any folder can be determined by visiting a folder in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/folders/123` the `folder_id` is `123`.
      - `etag` string, nullable — The HTTP `etag` of this folder. This can be used within some API endpoints in the `If-Match` and `If-None-Match` headers to only perform changes on the folder if (no) changes have happened.
      - `type` 'folder', required — The value will always be `folder`.
      - `sequence_id` string — A numeric identifier that represents the most recent user event that has been applied to this item. This can be used in combination with the `GET /events`-endpoint to filter out user events that would have occurred before this identifier was read. An example would be where a Box Drive-like application would fetch an item via the API, and then listen to incoming user events for changes to the item. The application would ignore any user events where the `sequence_id` in the event is smaller than or equal to the `sequence_id` in the originally fetched resource.
      - `name` string — The name 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)