Vercel

HealOps queries Vercel to retrieve deployment status and runtime logs — helping identify whether a recent deployment caused an incident or surface errors from serverless function executions.

Prerequisites

Vercel account with project access
Vercel API token

Setup

Option 1: Interactive CLI

healops integrations setup

Select Vercel when prompted and provide your API token.

Option 2: Environment variables

Add to your .env:

VERCEL_API_TOKEN=your-vercel-api-token
VERCEL_TEAM_ID=team_xxxxxxxxx   # optional, for team accounts

Variable	Default	Description
`VERCEL_API_TOKEN`	—	Required. Vercel API token
`VERCEL_TEAM_ID`	—	Team ID for team/organization accounts

Option 3: Persistent store

{
  "version": 1,
  "integrations": [
    {
      "id": "vercel-prod",
      "service": "vercel",
      "status": "active",
      "credentials": {
        "api_token": "your-vercel-api-token",
        "team_id": "team_xxxxxxxxx"
      }
    }
  ]
}

Creating a Vercel API token

In Vercel, go to Account Settings → Tokens
Click Create Token
Give it a name (e.g., healops) and set the scope to Full Account or a specific team
Copy the token

For team accounts, find your Team ID in Team Settings → General → Team ID.

Verify

healops integrations verify vercel

Expected output:

Service: vercel
Status: passed
Detail: Connected to Vercel API and listed 5 project(s)

Troubleshooting

Symptom	Fix
401 Unauthorized	Check that the API token is valid and not expired
403 Forbidden	The token may not have access to the team — check token scope
Projects not found	Ensure `VERCEL_TEAM_ID` is set if using a team account

Security best practices

Create a dedicated read-only token for HealOps — do not reuse deployment tokens.
Store the token in .env, not in source code.
Rotate tokens periodically.

Overview

LLM providers

Observability and incidents

Cloud, code, and collaboration

Messaging

Data and workflow systems

Prerequisites

Setup

Option 1: Interactive CLI

Option 2: Environment variables

Option 3: Persistent store

Creating a Vercel API token

Verify

Troubleshooting

Security best practices

​Prerequisites

​Setup

​Option 1: Interactive CLI

​Option 2: Environment variables

​Option 3: Persistent store

​Creating a Vercel API token

​Verify

​Troubleshooting

​Security best practices

Prerequisites

Setup

Option 1: Interactive CLI

Option 2: Environment variables

Option 3: Persistent store

Creating a Vercel API token

Verify

Troubleshooting

Security best practices