Box Developer Documentation
Log in

Integration mapping Teams

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

A Microsoft Teams specific representation of an integration mapping object.

string
12345

A unique identifier of a folder mapping (part of a composite key together with integration_type).

string
integration_mapping

Mapping type.

Value is always integration_mapping

object

The Box folder, to which the object from the partner app domain (referenced in partner_item_id) is mapped.

string
42037322

ID of the folder.

string
folder

The value will always be folder.

Value is always folder

string (date-time)
2012-12-12T10:53:43-08:00

When the integration mapping object was created.

string
teams

Identifies the Box partner app, with which the mapping is associated. Supports Slack and Teams. (part of the composite key together with id).

Value is always teams

boolean
true

Identifies whether the mapping has been manually set by the team owner from UI for channels (as opposed to being automatically created).

string (date-time)
2012-12-12T10:53:43-08:00

When the integration mapping object was last modified.

object
{"id":"19%3ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2","team_id":"hjgjgjg-bhhj-564a-b643-hghgj685u","tenant_id":"E1234567","type":"channel"}

Mapped item object for Teams.

string
19%ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2

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

string
channel

Type of the mapped item referenced in id.

Value is one of channel,team

string
abcd-defg-1235-7890

ID of the tenant that is registered with Microsoft Teams.

Response Example

{
  "id": "12345",
  "type": "integration_mapping",
  "box_item": {
    "id": "42037322",
    "type": "folder"
  },
  "created_at": "2012-12-12T10:53:43-08:00",
  "integration_type": "teams",
  "is_overridden_by_manual_mapping": true,
  "modified_at": "2012-12-12T10:53:43-08:00",
  "partner_item": {
    "id": "19%3ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2",
    "type": "channel",
    "team_id": "hjgjgjg-bhhj-564a-b643-hghgj685u",
    "tenant_id": "E1234567"
  }
}