Vercel Integration

The Zavu Vercel integration automatically provisions API keys and injects environment variables into your Vercel projects, enabling you to start sending messages in minutes.

Features

• One-Click Setup: Install from the Vercel Marketplace and connect in minutes
• Automatic API Key Provisioning: API keys are created and injected automatically
• Environment Variable Injection: ZAVUDEV_API_KEY (also as ZAVU_API_KEY) and ZAVU_PROJECT_ID are added to your Vercel projects
• Multi-Project Support: Connect multiple Vercel projects to a single Zavu project

Installation

1. Install from Vercel Marketplace

   Visit the Zavu Integration on Vercel Marketplace and click Add Integration.

2. Authorize Access

   Grant Zavu permission to access your Vercel account and projects.

3. Select Zavu Project

   Choose an existing Zavu project or create a new one to connect with your Vercel projects.

4. Choose Vercel Projects

   Select which Vercel projects should receive the Zavu environment variables.

Environment Variables

After installation, the following environment variables are automatically added to your selected Vercel projects:

Quick Start

Once the integration is complete, you can start sending messages immediately. The API key is already available as an environment variable.

Install the SDK

TypeScriptCopy
npm install @zavudev/sdk
# or: bun add @zavudev/sdk

Send Your First Message

TypeScriptNext.js API RouteNext.js Server ActionCopy
import Zavudev from "@zavudev/sdk";

const zavu = new Zavu({
  apiKey: process.env.ZAVUDEV_API_KEY!,
});

// Send a message
const { message } = await zavu.messages.send({
  to: "+1234567890",
  text: "Hello from Zavu!",
});

console.log("Message ID:", message.id);

Managing the Integration

View Connected Projects

Go to Integrations in your Zavu Dashboard to see all connected Vercel projects and their status.

Disconnect

Disconnect from Developers › Integrations in the Zavu dashboard. Zavu revokes the API key and removes the variables it added (ZAVUDEV_API_KEY, ZAVU_API_KEY, ZAVU_PROJECT_ID) from each connected Vercel project. If a project could not be cleaned, the integration's row says which one: remove the variables there by hand.

Rotate API Key

If you need to rotate your API key:

1. Go to API Keys in your Zavu Dashboard
2. Create a new API key
3. Update the ZAVUDEV_API_KEY environment variable in your Vercel project settings
4. Revoke the old API key

Troubleshooting

Environment Variables Not Appearing

If the environment variables are not showing up in your Vercel project:

1. Check the integration status in your Zavu Dashboard
2. Re-deploy your Vercel project to pick up the new environment variables
3. Ensure the integration has the correct permissions

OAuth Errors

If you encounter OAuth errors during setup:

1. Try disconnecting and reconnecting the integration
2. Clear your browser cookies for Vercel and Zavu
3. Ensure popup blockers are disabled

API Key Not Working

If messages fail to send:

1. Verify the API key is correctly set in your environment
2. Read the error code on the response or on the failed message: a daily ceiling (daily_limit_exceeded), a missing 10DLC campaign on a +1 SMS destination (ten_dlc_required), or a message the automated review stopped (RISK_BLOCKED, RISK_REJECTED, RISK_REVIEW_EXPIRED). See Sending limits
3. Review the API Logs for detailed error messages

Use Cases

Next Steps