Skip to content
Docs

Create a Team

POSThttps://api.vercel.com/v1/teams
Create a new Team under your account. You need to send a POST request with the desired Team slug, and optionally the Team name.
Request
import { Vercel } from "@vercel/sdk";


const vercel = new Vercel({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});


async function run() {
  const result = await vercel.teams.createTeam({
    slug: "a-random-team",
    name: "A Random Team",
  });


  console.log(result);
}


run();
Response
{
  "id": "team_nLlpyC6RE1qxqglFKbrMxlud",
  "slug": "string"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Body

application/json
slugstringRequired
The desired slug for the Team
namestringOptional
The desired name for the Team. It will be generated from the provided slug if nothing is provided
attributionobjectOptional
Attribution information for the session or current page

Response

200The team was created successfully
idstringRequired
Id of the created team
slugstringRequired

Errors

400One of the provided values in the request body is invalid. The slug is already in use
403You do not have permission to access this resource.
404Error
410Error