Sign in

v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Integration mappings

Create Slack integration mapping

Creates a Slack integration mapping by mapping a Slack channel to a Box item.

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

post/integration_mappings/slack

Request body

Example request

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

Response

Returns the created integration mapping.

idstring 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_createdboolean

Identifies whether the mapping has been manually set (as opposed to being automatically created).

created_atstring date-time

When the integration mapping object was created.

modified_atstring date-time

When the integration mapping object was last modified.

Example response

{
  "id": "12345",
  "type": "integration_mapping",
  "integration_type": "slack",
  "is_manually_created": true,
  "options": {
    "is_access_management_disabled": true
  },
  "created_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "modified_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "partner_item": {
    "type": "channel",
    "id": "C12378991223",
    "slack_workspace_id": "T12352314",
    "slack_org_id": "E1234567"
  },
  "box_item": {
    "id": "12345",
    "etag": "1",
    "type": "folder",
    "sequence_id": "3",
    "name": "Contracts"
  },
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00"
}