Skip to main content
API keys allow external applications, automation tools, and custom integrations to communicate securely with Valuez AI. Every API request must include a valid key to be authorized.

​
Generating an API Key

1

Open Settings

In your Valuez AI dashboard, click Settings in the left sidebar.
2

Go to API Keys

Select API Keys from the settings menu.
3

Create a new key

Click “Generate New Key” or “Create API Key” (exact button name may vary).
4

Name your key

Give it a descriptive label so you know what it’s used for - e.g. CRM Integration, Zapier Automation, or Production App.
5

Copy and store it securely

Copy the key immediately. For security reasons, the full key is only shown once. Store it in a secure location before closing the window.
API Keys Screen
Once you close the key creation dialog, you cannot view the full key again. If you lose it, you’ll need to revoke it and generate a new one.

​
Using Your API Key

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

​
Example

curl "https://api.valuez.ai/v1/agents" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.valuez.ai/v1/agents",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

print(response.json())

const response = await fetch("https://api.valuez.ai/v1/agents", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
});

const data = await response.json();

​
Managing Existing Keys

From the Settings → API Keys screen you can:
ActionHow
Rename a keyClick the edit icon next to the key name
Revoke a keyClick Delete or Revoke - this immediately blocks all requests using that key
Regenerate a keyRevoke the old one and create a new key with the same label
Revoking a key is immediate and cannot be undone. Any system using that key will lose access instantly. Update your integration with the new key before revoking the old one.

​
Security Best Practices

API keys must only be used server-side. Never include them in JavaScript that runs in a browser - they can be extracted and misused.
Store keys in environment variables, not hardcoded in your codebase:
    export VALUEZ_API_KEY="your-key-here"
Use a separate key for each system - CRM, automation tool, production app. This way, if one is compromised, you revoke only that key without breaking everything else.
Regularly audit your API Keys list and revoke any keys that are no longer in use.

​
Common Integration Use Cases

IntegrationWhat It Does
CRMAuto-create or update leads after every call completes
Calendar / SchedulingSync appointment bookings made by your AI agent
Zapier / MakeTrigger no-code automation workflows on call events
Custom ApplicationBuild internal tools that read call logs or manage agents
Analytics PlatformPush call data into your BI or reporting tools
For step-by-step integration guides, see Integrations.

​
Next Steps

Authentication

Understand how API authentication works and security best practices.

Integrations

Connect Valuez AI with your CRM, calendar, and automation tools.

Webhooks

Receive real-time event notifications when calls complete or agents take action.

API Reference

Full endpoint documentation once your API is published.