Sign in

v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
Teams

Retrieve a team

You can fetch the details of a single team, containing an array of admins that belong to this team.

get/teams/{team_id}

Path parameters

team_idstring required

The unique identifier of a given team.

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Response

successful

typestring

Value is always "team"

idstring

The id of the team

namestring

The name of the team

admin_idsinteger[]

The list of admin IDs that are a part of the team.

assignment_limitinteger nullable

The assignment limit for the team. This field is only present when the team's distribution type is load balanced.

distribution_methodstring nullable

Describes how assignments are distributed among the team members

Example response

{
  "type": "team",
  "id": "814865",
  "name": "Example Team",
  "admin_ids": [
    493881
  ],
  "admin_priority_level": {
    "primary_admin_ids": [
      493881
    ],
    "secondary_admin_ids": [
      814865
    ]
  },
  "assignment_limit": 10,
  "distribution_method": "round_robin"
}