Skip to main content

​
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

1

Navigate to Settings

Go to your Settings in the dashboard
Image
2

Access API Keys

Click on the “API Keys” tab
Image
3

Open Generate API Key

Click on the “Generate API Key” button
Image
4

Generate New Key

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

Copy and Store

Copy and securely store your API key - you won’t be able to see it again
Image
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 '{...}'

​
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:
  1. In your dashboard URL: https://os.voiceaiwrapper.app/en/{tenant-id}
  2. In the API documentation panel
  3. 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'

​
Troubleshooting

  • 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
  • Confirm your API key has the necessary permissions
  • Verify you’re accessing a campaign you have access to
  • Check that your tenant is active
  • 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