Sign in
Basic

Update team

Update the details of a specific team in your HubSpot account. This endpoint allows you to modify the team's information, such as its name or parent team ID. Ensure that the teamId provided in the path is correct, as it identifies the team to be updated.

patch/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.write)

Path parameters

teamIdstring required

The unique identifier of the team to update.

Request body

nameobject required

An object representing the new name for the team.

parentTeamIdobject required

An object representing the ID of the parent team to which this team will be associated.

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.