Skip to main content
POST
/
integration_mappings
/
teams
cURL
curl -X -L POST "https://api.box.com/2.0/integration_mappings/teams" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H 'content-type: application/json' \
     -d '{
          "partner_item": {
              "id": "19%3ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2",
              "type": "channel",
              "team_id": "hjgjgjg-bhhj-564a-b643-hghgj685u",
              "tenant_id": "E1234567"
          },
          "box_item": {
              "id": "42037322",
              "type": "folder"
          }
      }'
{
  "id": "12345",
  "type": "integration_mapping",
  "partner_item": {
    "id": "19%3ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2",
    "type": "channel",
    "tenant_id": "E1234567",
    "team_id": "hjgjgjg-bhhj-564a-b643-hghgj685u"
  },
  "box_item": {
    "type": "folder",
    "id": "42037322"
  },
  "integration_type": "teams",
  "is_overridden_by_manual_mapping": true,
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00"
}
This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.Learn more about Box SDK versioning strategy.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

A request to create a Teams Integration Mapping object.

​
partner_item
Integration mapping mapped item schema for type Teams · object
required

The schema for an integration mapping mapped item object for type Teams.

​
box_item
Folder reference · object
required

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

Response

Returns the created integration mapping.

A Microsoft Teams specific representation of an integration mapping object.

​
id
string
required

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

Example:

"12345"

​
type
enum<string>
required

Mapping type.

Available options:
integration_mapping
Example:

"integration_mapping"

​
partner_item
Integration mapping mapped item schema for type Teams · object
required

Mapped item object for Teams.

Example:
{
  "id": "19%3ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2",
  "type": "channel",
  "tenant_id": "E1234567",
  "team_id": "hjgjgjg-bhhj-564a-b643-hghgj685u"
}
​
box_item
Folder reference · object
required

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

​
integration_type
enum<string>

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

Available options:
teams
Example:

"teams"

​
is_overridden_by_manual_mapping
boolean

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

Example:

true

​
created_at
string<date-time>

When the integration mapping object was created.

Example:

"2012-12-12T10:53:43-08:00"

​
modified_at
string<date-time>

When the integration mapping object was last modified.

Example:

"2012-12-12T10:53:43-08:00"