This endpoint is used to create Teams: user groups which are groups of users you can assign items to in your Workspace.
In our API documentation, team_id
refers to the id of a Workspace, and group_id
refers to the id of a user group.
Note: Adding a guest with view only permissions to a Team automatically converts them to a paid guest.
If you don't have any paid guest seats available, a new member seat is automatically added to increase the number of paid guest seats available.
This incurs a prorated charge based on your billing cycle.
{- "name": "New team name",
- "members": [
- 123456,
- 987654
]
}
{- "id": "4bfdfcec-6f4f-40a7-b0d6-22660d51870d",
- "team_id": "301540",
- "userid": 301828,
- "name": "User group",
- "handle": "usergroup",
- "date_created": "1640122639829",
- "initials": "U",
- "members": [
- {
- "id": 185,
- "username": "Sam",
- "email": "sam@example.com",
- "color": "#4169E1",
- "initials": "S",
}, - {
- "id": 186,
- "username": "Alex",
- "email": "alex@example.com",
- "color": "#4169E1",
- "initials": "A",
}
], - "avatar": {
- "attachment_id": null,
- "color": null,
- "source": null,
- "icon": null
}
}