Sign in
Basic

Retrieve team

Retrieve detailed information about a specific team in your HubSpot account using the team's unique identifier. This endpoint is useful for accessing the team's properties, such as its name and parent team ID, to manage or display team-related data.

get/settings/teams/2026-09/{teamId}

Request

  • Base URL: https://api.hubapi.com
  • URL: https://api.hubapi.com/settings/teams/2026-09/{teamId}
  • Auth: OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: settings.users.teams.read)

Path parameters

teamIdstring required

The unique identifier of the team to retrieve.

Response

successful operation

idstring required

The unique identifier for the team, represented as a string.

namestring required

The name of the team, represented as a string.

parentTeamIdstring

The unique identifier of the parent team, if applicable, represented as a string.

Changes

No recorded changes to this operation across all 1 revision of this API.