Sign in
Basic

Add Team Members

Assign new members to a specific team in your HubSpot account. This endpoint allows you to add users to a team by specifying their user IDs and roles. It is useful for managing team compositions and ensuring the right users have access to team resources.

post/settings/teams/2026-09/{teamId}/members

Request

  • Base URL: https://api.hubapi.com
  • URL: https://api.hubapi.com/settings/teams/2026-09/{teamId}/members
  • 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 which members will be added.

Request body

type'DEFAULT' | 'EXTRA' required

The type of team member assignment. It is a string and can be either 'DEFAULT' or 'EXTRA'.

userIdstring required

The unique identifier for the user being assigned to the team. It is a string.

Response

successful operation

type'DEFAULT' | 'EXTRA' required

The type of membership the user has in the team. Valid values are 'DEFAULT' and 'EXTRA'.

userIdstring required

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

Changes

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