Skip to main content
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 and x-source: console header.
string
required
Bearer token for authentication. Format: Bearer YOUR_ACCESS_TOKEN
string
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

Causes:
  • Missing team name
  • Team name too short or too long
  • Invalid characters in team name
Causes:
  • Missing or invalid access token
  • Expired access token
  • Missing x-source header
Causes:
  • User lacks team creation permissions
  • User is not an organization admin
Causes:
  • 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

  • Use descriptive and clear team names
  • Follow consistent naming conventions
  • Avoid special characters and spaces
  • Keep names under 50 characters
  • Ensure users have proper permissions before team creation
  • Implement role-based access control
  • Monitor team creation activities
  • Handle duplicate team name errors gracefully
  • Provide clear error messages to users
  • Implement retry logic for transient failures

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.
Pro Tip: Create teams with clear, descriptive names that reflect their purpose or department. This makes team management and member assignment much easier.