Create a Team | Vercel REST API

APIs & SDKs

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.

https://api.vercel.com/v1/teams

const response = await fetch('https://api.vercel.com/v1/teams', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "slug": "a-random-team",
    "name": "A Random Team",
    "attribution": {
      "sessionReferrer": "string",
      "landingPage": "string",
      "pageBeforeConversionPage": "string",
      "utm": {
        "utmSource": "string",
        "utmMedium": "string",
        "utmCampaign": "string",
        "utmTerm": "string"
      }
    }
  }),
});

const data = await response.json();
console.log(data);

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

Cross-link map: Create a Team (/docs/rest-api/teams/create-a-team)

From the Vercel docs graph (built 2026-10-13T05:35:52.211Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Delete a Team — DELETE /v1/teams/{teamId} — Delete a team under your account. You need to send a \DELETE\\ request with the desired tea
Request access to a team — POST /v1/teams/{teamId}/request — Request access to a team as a member. An owner has to approve the request. Only 100 us
Join a team — POST /v1/teams/{teamId}/members/teams/join — Join a team with a provided invite code or team ID.
Invite a user — POST /v2/teams/{teamId}/members — Invite a user to join the team specified in the URL. The authenticated user needs to b
List all teams — GET /v2/teams — Get a paginated list of all the Teams the authenticated User is a member of.

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (1)

By site: vercel-docs (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/v1/teams

const response = await fetch('https://api.vercel.com/v1/teams', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "slug": "a-random-team",
    "name": "A Random Team",
    "attribution": {
      "sessionReferrer": "string",
      "landingPage": "string",
      "pageBeforeConversionPage": "string",
      "utm": {
        "utmSource": "string",
        "utmMedium": "string",
        "utmCampaign": "string",
        "utmTerm": "string"
      }
    }
  }),
});

const data = await response.json();
console.log(data);

Response

{
  "id": "team_nLlpyC6RE1qxqglFKbrMxlud",
  "slug": "string"
}

OpenAPI Specification