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

Documentation Index

Fetch the complete documentation index at: https://developer.box.com/llms.txt

Use this file to discover all available pages before exploring further.

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"