Console APIs - Teams
Create Team
Create a new team within your organization
POST
Create Team
Create a new team within your organization for better collaboration and member management.Authentication
This endpoint requires Console API authentication with bearer token andx-source: console header.
string
required
Bearer token for authentication. Format:
Bearer YOUR_ACCESS_TOKENstring
required
Source identifier. Must be set to
console for all Console API requests.Request Body
string
required
The name of the team to create. Must be unique within the organization.
Response Fields
object
required
Team data object containing the created team information.
string
required
Human-readable message describing the result of the operation.
string
required
Operation status. Always “success” for successful team creation.
Error Responses
400 Bad Request
400 Bad Request
- Missing team name
- Team name too short or too long
- Invalid characters in team name
403 Forbidden
403 Forbidden
- User lacks team creation permissions
- User is not an organization admin
409 Conflict
409 Conflict
- Team name already exists in the organization
- Duplicate team creation attempt
Usage Examples
Team Management Workflow
Create Team
Use this endpoint to create a new team with a unique name.
Invite Members
Use the invite team member endpoint to add users to the team.
Manage Roles
Update team member roles as needed for proper access control.
Monitor Team
Use the get teams endpoint to monitor team activity and membership.
Best Practices
Team Naming
Team Naming
- Use descriptive and clear team names
- Follow consistent naming conventions
- Avoid special characters and spaces
- Keep names under 50 characters
Permission Management
Permission Management
- Ensure users have proper permissions before team creation
- Implement role-based access control
- Monitor team creation activities
Error Handling
Error Handling
- Handle duplicate team name errors gracefully
- Provide clear error messages to users
- Implement retry logic for transient failures
Related Endpoints
Get Teams
Retrieve all teams in your organization.
Invite Team Member
Add new members to the team.
Get Team Members
View all members of a specific team.
Delete Team
Remove a team from your organization.