Skip to content
Docs

Create or Add Team to Organization

POST/__remote/api.vercel.com/v1/organizations/{organizationId}/teams
Create a new team under an organization, or add an existing team. mode: "create" creates a brand-new child team from slug + name — a platform child by default, or an enterprise child (billed on the organization root's flex subscription) when billingPlan: "enterprise" is supplied. mode: "link" links an existing team identified by teamId or slug; the child's billing profile is derived from the target team's plan (enterprise team → enterprise child, else platform), or explicitly supplied. Both modes respond with the resulting organization-team link. This endpoint is in private beta. Contact your Edgenivo account team for access.
/__remote/api.vercel.com/v1/organizations/{organizationId}/teams
const response = await fetch('/__remote/api.vercel.com/v1/organizations/organizationId/teams', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "mode": "create",
    "teamId": "example_id",
    "slug": "string",
    "name": "value",
    "billingPlan": "enterprise"
  }),
});


const data = await response.json();
console.log(data);
Response
{
  "billingPlan": "enterprise",
  "createdAt": "string",
  "organizationId": "example_id",
  "ssoMode": "organization",
  "teamId": "example_id",
  "updatedAt": "string"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

organizationIdstringRequired
The ID of the organization to create or add a team under.

Body

application/json
modeobjectRequired
teamIdstringOptional
The ID of an existing team to add to the organization (link mode).
slugstringRequired
The slug of an existing team to link, or the slug for a new team to create.
nameobjectRequired
billingPlanstringOptional

Response

200Success
billingPlanstringOptional
The child team's billing profile within the organization. Optional: links created before this attribute existed have no stored value.
createdAtstringRequired
organizationIdstringRequired
ssoModestringRequired
teamIdstringRequired
updatedAtstringRequired

Errors

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