Sign in
Basic

Create Team

Create a new team in your HubSpot account. This endpoint allows you to define the team's name, parent team, and members. The request body must include the team's name and members. Upon successful creation, the response will include the URL of the newly created team resource.

post/settings/teams/2026-09

Request

  • Base URL: https://api.hubapi.com
  • URL: https://api.hubapi.com/settings/teams/2026-09
  • 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)

Request body

namestring required

The name of the team to be created. This is a required field and must be a string.

parentTeamIdstring

The unique identifier of the parent team, if the new team is a sub-team. This is an optional field and must be a string if provided.

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.