teams
Create team
Creates a new team in your workspace. You must provide the team name and a unique handle for @mentions.
Required Fields
- name: The name of the team (1-255 characters, must be unique per workspace)
- handle: Unique handle for @mentions (lowercase alphanumeric only, 1-255 characters, must be unique per workspace)
Response
Returns a reference to the created team with its ID and self link. Use the GET endpoint to retrieve the full team details.
post/teams
Request body
Example request
{
"data": {
"fields": {
"name": "Product Team",
"handle": "productteam",
"description": "Team responsible for product development"
}
}
}Response
Team created successfully
Example response
{
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"type": "team",
"links": {
"self": "https://api.productboard.com/v2/teams/123e4567-e89b-12d3-a456-426614174000",
"members": "https://api.productboard.com/v2/teams/123e4567-e89b-12d3-a456-426614174000/members",
"html": "https://example.productboard.com/settings/teams/12"
}
}
}