List all teams

Example Request & Response

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

You can fetch a list of all teams for a given workspace.

Response

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

Team List

AttributeTypeDescription
typestringValue is 'team.list'
teamsarrayA list of team objects
pagesobjectOptional. A pagination object, which may be empty, indicating no further pages to fetch.