Authentication

API Keys

All API requests (both v1 and v2) must be authenticated using an API key. You can generate and manage API keys from your campaign’s dashboard.

Generating an API Key

Navigate to Settings

Go to your Settings in the dashboard

Access API Keys

Click on the “API Keys” tab

Open Generate API Key

Click on the “Generate API Key” button

Generate New Key

Click “Generate API Key” and give it a descriptive name

Copy and Store

Copy and securely store your API key - you won’t be able to see it again

Security: Keep your API keys secure and never share them publicly. If a key is compromised, disable it immediately and generate a new one.

Using Your API Key

Include your API key in the Authorization header of every request:

curl --location 'https://api.voiceaiwrapper.app/api/v2/voice-campaigns/{campaignId}/leads' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{...}'

const response = await fetch('https://api.voiceaiwrapper.app/api/v2/voice-campaigns/{campaignId}/leads', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({...})
});

import requests

url = 'https://api.voiceaiwrapper.app/api/v2/voice-campaigns/{campaignId}/leads'
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
}
response = requests.post(url, headers=headers, json={...})

Finding Your Tenant ID (v1 Only)

v2 Users: You can skip this section. v2 automatically determines your tenant ID from your API key.

If you’re using API v1, you’ll need to include your tenant_id in request bodies. You can find it:

In your dashboard URL: https://dashboard.voiceaiwrapper.app/en/{tenant-id}
In the API documentation panel
By contacting support

Managing API Keys

Viewing API Keys

All your API keys are listed in the API Keys tab with:

Name
Status (Active/Disabled)
Masked key value (for security)

Enabling/Disabling Keys

Toggle the switch next to each API key to enable or disable it instantly. Disabled keys cannot authenticate requests.

Deleting API Keys

Click the actions menu next to a key to permanently delete it. This action cannot be undone.

Best Practice: Create separate API keys for different applications or environments (development, staging, production). This makes key rotation easier and improves security.

Testing Your Authentication

Try making a simple API call to verify your authentication is working:

curl --location 'https://api.voiceaiwrapper.app/api/v2/voice-campaigns/{campaignId}/leads' \
--header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch('https://api.voiceaiwrapper.app/api/v2/voice-campaigns/{campaignId}/leads', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

console.log(response.status); // Should be 200 if authenticated

import requests

response = requests.get(
    'https://api.voiceaiwrapper.app/api/v2/voice-campaigns/{campaignId}/leads',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

print(response.status_code)  # Should be 200 if authenticated

Troubleshooting

401 Unauthorized Error

Verify your API key is correct and hasn’t been disabled
Check that you’re including the “Bearer ” prefix
Ensure the key hasn’t been deleted

403 Forbidden Error

Confirm your API key has the necessary permissions
Verify you’re accessing a campaign you have access to
Check that your tenant is active

API Key Not Working

Generate a new API key and try again
Verify you copied the entire key without spaces
Check that the key is enabled in the dashboard

Getting Started

Campaigns

Client Account Configurations

Web Widgets

Client Forms

Agents

Clients

Voice Providers

Leads (v1)

Leads (v2)

External Billing

API Keys

Generating an API Key

Using Your API Key

Finding Your Tenant ID (v1 Only)

Managing API Keys

Viewing API Keys

Enabling/Disabling Keys

Deleting API Keys

Testing Your Authentication

Troubleshooting

​API Keys

​Generating an API Key

​Using Your API Key

​Finding Your Tenant ID (v1 Only)

​Managing API Keys

​Viewing API Keys

​Enabling/Disabling Keys

​Deleting API Keys

​Testing Your Authentication

​Troubleshooting

API Keys

Generating an API Key

Using Your API Key

Finding Your Tenant ID (v1 Only)

Managing API Keys

Viewing API Keys

Enabling/Disabling Keys

Deleting API Keys

Testing Your Authentication

Troubleshooting