Create a team

POST 
/v1/teams

This route allows you to create a new team in your Port organization.

To learn more about teams, check out the documentation.

Request

application/json

Body

required

namestringrequired

The name of the new team.


Possible values: Value must match regular expression ^[^;#/\?\s][^;#/\?]*[^;#/\?\s]$

usersstring[]

One or more e-mail addresses of users to add to the new team.


descriptionstring

The description of the new team.

Responses

200

Created successfully.

application/json

Schema

Schema

okanyrequired

Possible values: [true]

team

object

required

idstring

namestring

createdAtdate-time

updatedAtdate-time

providerstring

descriptionstring

users

object[]

Array [

emailstring

firstNamestring

lastNamestring

picturestring

statusstring

]

Example (from schema)

{
  "ok": true,
  "team": {
    "id": "string",
    "name": "string",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "updatedAt": "2024-07-29T15:51:28.071Z",
    "provider": "string",
    "description": "string",
    "users": [
      {
        "email": "string",
        "firstName": "string",
        "lastName": "string",
        "picture": "string",
        "status": "string"
      }
    ]
  }
}