Skip to main content
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: 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:
VariableDescription
ZAVU_API_KEYYour Zavu API key for authentication
ZAVU_PROJECT_IDYour Zavu project ID
Environment variables are injected for all environments (Development, Preview, and Production).

​
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

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

​
Send Your First Message

import Zavudev from "@zavudev/sdk";

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

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

console.log("Message ID:", message.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 Projects

To disconnect a Vercel project:
  1. Go to your Vercel Dashboard
  2. Navigate to Settings > Integrations
  3. Find Zavu and click Configure
  4. Remove the integration from specific projects
Disconnecting the integration will not automatically remove the environment variables from your Vercel project. You may need to remove them manually.

​
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 ZAVU_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. Check that your Zavu project is not in sandbox mode (or that you’re sending to verified numbers)
  3. Review the API Logs for detailed error messages

​
Use Cases

Transactional Notifications

Send order confirmations, shipping updates, and password resets

Two-Factor Authentication

Implement SMS-based 2FA for your Next.js applications

Customer Support

Enable WhatsApp messaging for real-time customer communication

Marketing Campaigns

Run targeted SMS and WhatsApp marketing campaigns

​
Next Steps

Sending Messages

Learn different ways to send messages

WhatsApp

Send rich WhatsApp messages with media and buttons

Webhooks

Receive delivery status updates and incoming messages

AI Agents

Build automated conversational agents