CDB Infotech

Outbound AI Calling API

Trigger outbound phone calls via Vapi-powered AI voice agent.

Method POST
Auth Bearer Token
Format JSON
Version v1

Endpoint

Send a JSON payload to trigger an AI outbound call.

POST https://ai-calling-api.cdbinfotech.com/call/6853cc69b79b8762c7405028/outbound

Authentication

This API uses Bearer Token authentication. Include your token in the Authorization header.

HeaderExample
Authorization Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiJDJhJDEwJGJFSGU3TFZIRDN5TnlhdzIzeDhCTHUuLnZ4QlhpRnJZa2FoTjgwLzVtYVF4MXZIT2FrWm0uIiwiaWF0IjoxNzYxNTY4NDkxfQ.LgfHFK7kreW_kO0r4tRaS6m7pfOICAS_RUC25HUJfTw
Content-Type application/json
Security note: Treat the token as confidential. Rotate immediately if exposed.

Request Body

FieldTypeRequiredDescription
lead_namestringYesLead’s full name used by the AI during the call.
to_numberstringYesDestination phone number, preferably in E.164 format (e.g., +918765432100).

Sample Request

curl -X POST   https://ai-calling-api.cdbinfotech.com/call/6853cc69b79b8762c7405028/outbound   -H "Content-Type: application/json"   -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjoiJDJhJDEwJGJFSGU3TFZIRDN5TnlhdzIzeDhCTHVrNEouQkpkeExuNjIwT0luVHBKLlB2SUxsM0JDNm02IiwiaWF0IjoxNzYxNTU4NzEwfQ.Su02X3b_UXPTTtac0Ro1vWs9gOlEPDPhC3k9hsrQoJo"   -d '{
    "lead_name": "Rohit Sharma",
    "to_number": "+918765432100"
  }'

HTTP Responses

StatusMeaningBody (example)
200 OK Call initiated successfully 
{
  "status": "success",
  "message": "Outbound call initiated successfully",
  "call_id": "ab72e1f3-dc01-4f90-9bb8-1f43c9bc92aa",
  "to_number": "+918765432100",
  "lead_name": "Rohit Sharma"
}
400 Bad Request Missing or invalid fields 
{
  "status": "error",
  "message": "Missing required field: to_number"
}
401 Unauthorized Invalid or missing token 
{
  "status": "error",
  "message": "Unauthorized"
}
429 Too Many Requests Rate limit exceeded 
{
  "status": "error",
  "message": "Rate limit exceeded. Try again later."
}
500 Server Error Unexpected server-side error 
{
  "status": "error",
  "message": "Internal server error"
}

Idempotency & Rate Limits

  • Recommended max: 10 requests/second.
  • If you need stricter duplicate protection, add an Idempotency-Key header on your side (optional; not enforced by API).

Postman (Quick Import)

Create a POST request to the endpoint above, set headers Content-Type: application/json and Authorization: Bearer <token>, and paste the sample JSON.

Minimal OpenAPI Snippet

openapi: 3.0.3
info:
  title: Outbound AI Calling API
  version: "1.0"
paths:
  /call/6853cc69b79b8762c7405028/outbound:
    post:
      summary: Trigger an outbound AI call
      security:
        - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                lead_name: { type: string }
                to_number: { type: string }
              required: [lead_name, to_number]
      responses:
        "200":
          description: Call initiated
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "429":
          description: Too Many Requests
        "500":
          description: Server error
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

Testing Tips

  • Use E.164 numbers (e.g., +91 prefix for India).
  • Verify your destination numbers can receive calls.
  • Check your Vapi project for call logs using the returned call_id (if logging enabled).
© CDB Infotech — Outbound AI Calling API