Skip to main content
POST
/
v2
/
teams
/
{teamId}
/
members
inviteUserToTeam
import { Vercel } from "@vercel/sdk";

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

async function run() {
  const result = await vercel.teams.inviteUserToTeam([
    {
      email: "john@example.com",
      projects: [
        {
          projectId: "prj_ndlgr43fadlPyCtREAqxxdyFK",
          role: "ADMIN",
        },
      ],
    },
  ]);

  console.log(result);
}

run();
{
  "uid": "kr1PsOIzqEL5Xg6M4VZcZosf",
  "username": "john-doe",
  "email": "john@user.co",
  "role": "MEMBER",
  "teamRoles": [
    "MEMBER"
  ],
  "teamPermissions": [
    "CreateProject"
  ]
}

Authorizations

Authorization
string
header
required

Default authentication mechanism

Body

application/json · object[]
email
string<email>
required

The email address of the user to invite

Example:

"john@example.com"

role
enum<string>
default:VIEWER

The role of the user to invite

Available options:
OWNER,
MEMBER,
DEVELOPER,
SECURITY,
BILLING,
VIEWER,
VIEWER_FOR_PLUS,
CONTRIBUTOR
Example:

"VIEWER"

projects
object[]

Response

The member was successfully added to the team.

uid
string
required

The ID of the invited user

Example:

"kr1PsOIzqEL5Xg6M4VZcZosf"

username
string
required

The username of the invited user

Example:

"john-doe"

email
string
required

The email of the invited user.

Example:

"john@user.co"

role
enum<string>
required

The role used for the invitation

Available options:
OWNER,
MEMBER,
DEVELOPER,
SECURITY,
BILLING,
VIEWER,
VIEWER_FOR_PLUS,
CONTRIBUTOR
Example:

"MEMBER"

teamRoles
enum<string>[]

The team roles of the user

Example:
["MEMBER"]
teamPermissions
enum<string>[]

The team permissions of the user

Example:
["CreateProject"]