Vercel integration overview

Overview

Vercel is a cloud platform for deploying web applications, preview environments, and serverless workloads. Persona’s Vercel integration lets teams list existing projects and create new projects directly from Persona workflows.

This integration is especially useful for engineering, operations, and trust teams that want identity or review events in Persona to trigger consistent project-management and environment-provisioning actions in Vercel.

Benefits

Automate project provisioning: Create a Vercel project from a Persona workflow with the framework, build settings, repository, and environment configuration your team requires.

Improve operational visibility: Retrieve Vercel projects and their configuration without manually switching between Persona and Vercel.

Support team and personal scopes: Run actions in a Vercel team’s scope or the authenticated user’s personal scope.

Standardize deployment settings: Apply consistent framework, command, directory, region, and source-control settings when workflows create projects.

Integration Features

Persona’s Vercel integration supports project discovery and creation. Key capabilities include:

• List Projects: Retrieve projects in a personal or team scope, with optional search, repository filtering, and pagination.
• Create Project: Create a project with optional framework, build, directory, Git repository, environment variable, and deployment settings.

Setting up the Vercel integration

Prerequisites

To set up the Vercel integration, ensure you have:

• A Vercel account with access to the personal or team scope you want to use
• A Vercel access token with permission to list or create projects in that scope
• Permission to manage integrations in the Persona Dashboard

Setting up the Vercel credentials

1. In the Persona Dashboard, navigate to Integrations > Marketplace and click Vercel.
2. Click Add Credential.
3. Enter a nickname for the credential and provide your Vercel access token.
4. Click Continue to save the credential.
5. Confirm that the credential appears on the Vercel integration page.

Using the Vercel integration in a workflow

1. Create a new workflow or open an existing workflow.
2. Add a new Action Step > Integrations.
3. Select Vercel and choose your saved credential.
4. Select the operation you want to run.
5. Map Persona data into the operation’s input fields.
6. Save and publish the workflow.

Vercel Operations Overview

List Projects

Retrieve projects from the authenticated user’s personal scope or a Vercel team. Use the response to find project IDs, inspect configuration, or pass project details into later workflow steps.

Configuration Steps:

Optionally add:

• Team ID or Team Slug
• Project Name Search
• Limit
• Pagination Token
• Git Repository Filter

Create Project

Create a Vercel project in a personal or team scope.

Configuration Steps:

Provide values for required fields:

• Project Name

Optionally add:

• Team ID or Team Slug
• Framework
• Build, Development, and Install Commands
• Output and Root Directories
• Serverless Function Region
• Git Repository
• Environment Variables
• Public Source and deployment behavior settings

FAQs

How do I create a Vercel access token?

Create an access token in your Vercel account settings. The token must have access to the personal account or team where the workflow will list or create projects.

Should I use Team ID or Team Slug?

Either value can identify the Vercel team scope. Provide only one. If both are omitted, the action uses the authenticated user’s personal scope.

Can I connect a Git repository when creating a project?

Yes. The Create Project action accepts Git repository settings. The authenticated Vercel account must also have access to the repository.

Does creating a project deploy it immediately?

Creating a project configures it in Vercel. A deployment requires source activity or another deployment trigger supported by the project’s configuration.