Quickstart
This guide will walk you through making your first API call to Nedzo.
Prerequisites
Before you begin, make sure you have:
- A Nedzo account with API access
- Your API key from the dashboard
Step 1: Get Your API Key
Navigate to API Keys
Click on Settings → API Keys
Create a Key
Click Create API Key, give it a name, and copy the key
Store your API key securely. It provides full access to your account and cannot be retrieved after creation.
Step 2: Make Your First Request
Let’s verify your API key works by listing your workspaces:
curl https://api.nedzo.ai/v1/workspaces \
-H "Authorization: Bearer YOUR_API_KEY"
Step 3: Create an Agent
Now let’s create your first AI voice agent:
curl -X POST https://api.nedzo.ai/v1/agents \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "YOUR_WORKSPACE_ID",
"name": "Sales Agent",
"systemPrompt": "You are a friendly sales representative...",
"voiceId": "rachel",
"language": "en"
}'
Step 4: Make a Call
With an agent created, you can now initiate a call:
curl -X POST https://api.nedzo.ai/v1/call \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agentId": "YOUR_AGENT_ID",
"phoneNumber": "+14155551234",
"variables": {
"customerName": "John"
}
}'
Next Steps
