Skip to main content

​
Get Started with Dialgen

This guide will help you make your first AI-powered voice call using the Dialgen API.

​
Step 1: Obtain Your API Key

All requests to the Dialgen API require authentication with a Bearer Token. You can generate and manage your API keys at sa.dialgen.ai/api-keys. Once generated, keep it secure.

​
Step 2: Make Your First Call

Use the Start a Single Call endpoint to initiate an outbound call. Replace YOUR_API_KEY with your actual API key and adjust the to, agentConfigId, and userId fields as necessary. You can find your userId in the sa.dialgen.ai dashboard. 
curl -X POST https://sa.dialgen.ai/api/v1/call/dial \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ 
    "to": "+1234567890", 
    "agentConfigId": "agent_123", 
    "userId": "YOUR_USER_ID", 
    "callerDetails": {
      "name": "John Doe",
      "email": "[email protected]"
    }
  }'
Upon success, you will receive a callId which you can use to monitor the call’s status.

​
Step 3: Explore the API

Now that you’ve made your first call, you can explore other functionalities:
  • Monitor Call Status: Check the live status of your calls.
  • Create Batch Campaigns: Initiate high-volume call campaigns.
  • Retrieve Call Metrics: Get detailed analytics and summaries for completed calls.
For more details on these and other endpoints, refer to the API Reference.