DocsBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

List Teams

List Teams

$ curl https://api.intercom.io/teams \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept: application/json'
HTTP/1.1 200 Ok
{
    "teams": [
        {
            "admin_ids": [
                492881,
                1195856
            ],
            "id": "814865",
            "name": "BA_App",
            "type": "team"
        },
        {
            "admin_ids": [
                646303,
                814860
            ],
            "id": "2744328",
            "name": "the_a_team",
            "type": "team"
        }
    ],
    "type": "team.list"
}

An App's teams can be fetched by sending a GET request to https://api.intercom.io/teams.

Team List

Attribute

Type

Description

type

string

Value is 'team.list'

teams

array

A list of team objects

pages

object

Optional. A pagination object, which may be empty, indicating no further pages to fetch.

Request Parameters

None.

Returns

A list of team objects for the App. The result may also have a pages object if the response is paginated.