Box Developer Documentation
Log in

Create Slack integration mapping request

This resource is used by endpoints in the version 2024.0. For more details, see Box API versioning.

A request to create a Slack Integration Mapping object.

object

The schema for an integration mapping Box item object for type Slack.

string
1234567891

ID of the mapped item (of type referenced in type).

string
folder

Type of the mapped item referenced in id.

Value is always folder

object

The schema for an integration mapping options object for Slack type.

boolean
true

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.

object

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.

string
C12378991223

ID of the mapped item (of type referenced in type).

string
channel

Type of the mapped item referenced in id.

Value is always channel

string
E1234567

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.

string
T12352314

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.

Response Example

{
  "box_item": {
    "id": "1234567891",
    "type": "folder"
  },
  "options": {
    "is_access_management_disabled": true
  },
  "partner_item": {
    "id": "C12378991223",
    "type": "channel",
    "slack_org_id": "E1234567",
    "slack_workspace_id": "T12352314"
  }
}