How to Create a Voice Agent Account

Create a voice agent account to enable your application to send and receive voice messages through the Carbon Voice API.

Steps

1. Navigate to Agents

   • Desktop app, web, or Developer Portal: Select "Agents" on the left sidebar
   • Mobile: Select "Agents" under the profile menu

2. Create an Agent

   • Click "Create Agent"
   • Enter a name for your agent (e.g., "My Voice Bot")
   • Configure any additional settings as needed
   • Save your agent

3. Generate a Personal Access Token (PAT)

   • Select your newly created agent
   • Navigate to the "Tokens" or "API Keys" section
   • Click "Generate Token" or "Create PAT"
   • The token will be prefixed with cv_pat_
   • Copy the token immediately — you won't be able to see it again

4. Store Your Token Securely

   • Save the PAT in a secure location (environment variables, secrets manager, or .env file)
   • Never commit your PAT to version control
   • Add .env to your .gitignore file if using environment variables

Using Your PAT

Include the PAT in the Authorization header for all API requests:

Authorization: Bearer cv_pat_<your-token>

Managing Your Agent

• View agents: Access all your agents from the Developer Portal dashboard
• Revoke tokens: Revoke compromised or unused PATs from the agent settings
• Register Webhooks: Register webhooks to receive events from the agent
• Update settings: Modify agent configuration as needed

Security Best Practices

• Rotate PATs periodically
• Restrict webhook registration to trusted users only
• Use separate agent accounts for different environments (dev, staging, production)
• Never share PATs in public repositories or communication channels

Troubleshooting

Issue: Need to regenerate a lost token

• You'll need to create a new PAT — old tokens cannot be retrieved
• Update your application with the new token
• Revoke the old token if it was compromised