organizations

Create or Add Team to Organization

Changed on

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 Vercel account team for access.

post/v1/organizations/{organizationId}/teams

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v1/organizations/{organizationId}/teams
  • Auth: HTTP bearer

Path parameters

organizationIdstring required

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

Request body

mode'create' required

Whether to create a new team under the organization ("create") or link an existing one ("link").

namestring required

The display name for a new team. Required in create mode; rejected in link mode.

teamIdstring

The ID of an existing team to add to the organization (link mode).

slugstring required

The slug of an existing team to link, or the slug for a new team to create.

billingPlan'enterprise' | 'platform'

Response

billingPlan'enterprise' | 'platform'

The child team's billing profile within the organization. Optional: links created before this attribute existed have no stored value.

createdAtstring required
organizationIdstring required
ssoMode'organization' | 'team' required
teamIdstring required
updatedAtstring required

Changes