Join BoxWorks 2024 to discover what's possible with content and AI!

Create Slack integration mapping request

A request to create a Slack Integration Mapping object

box_item object

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

box_item.id string

example1234567891

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

box_item.type string

examplefolder

Type of the mapped item referenced in id

Value is always folder

options object

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

options.is_access_management_disabled boolean

exampletrue

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.

partner_item 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.

partner_item.id string

exampleC12378991223

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

partner_item.type string

examplechannel

Type of the mapped item referenced in id

Value is always channel

partner_item.slack_org_id string

exampleE1234567

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.

partner_item.slack_workspace_id string

exampleT12352314

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"
  }
}