Configuring Your Account

After your partner application is approved, configure your account to start making calls. This guide covers webhook setup, telephony configuration, and verifying your account is ready.

View your configuration

Start by checking your current partner configuration:

curl -X GET https://api.vocobase.com/api/v2/config \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012"

const response = await fetch("https://api.vocobase.com/api/v2/config", {
  headers: {
    "Authorization": "Bearer rg_live_abc123def456ghi789jkl012"
  }
});
const config = await response.json();
console.log(config.data);

import requests

response = requests.get(
    "https://api.vocobase.com/api/v2/config",
    headers={"Authorization": "Bearer rg_live_abc123def456ghi789jkl012"}
)
print(response.json()["data"])

The response shows your agent limit, allowed voices and languages, webhook status, and telephony configuration:

{
  "success": true,
  "data": {
    "name": "acme-corp",
    "display_name": "Acme Corporation",
    "agent_limit": 10,
    "current_agent_count": 0,
    "allowed_voices": ["a0e99841-438c-4a64-b679-ae501e7d6091"],
    "allowed_languages": ["en", "hi", "es"],
    "status": "active",
    "webhook": {
      "configured": false,
      "url": null,
      "secret": null
    },
    "webhooks": [],
    "telephony": {
      "twilio": { "configured": false },
      "mcube": { "configured": false }
    }
  }
}

Set up webhooks

Configure one or more webhook endpoints to receive live call status updates and final session results. Use call.status.updated for partner queue orchestration and concurrency release; use session.completed for transcripts, extraction results, and recording URLs.

curl -X POST https://api.vocobase.com/api/v2/config/webhooks \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "prod",
    "url": "https://your-server.com/webhooks/vocobase"
  }'

const response = await fetch("https://api.vocobase.com/api/v2/config/webhooks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer rg_live_abc123def456ghi789jkl012",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    label: "prod",
    url: "https://your-server.com/webhooks/vocobase"
  })
});
const result = await response.json();
console.log(result.data.secret); // Save this!

import requests

response = requests.post(
    "https://api.vocobase.com/api/v2/config/webhooks",
    headers={
        "Authorization": "Bearer rg_live_abc123def456ghi789jkl012",
        "Content-Type": "application/json"
    },
    json={
        "label": "prod",
        "url": "https://your-server.com/webhooks/vocobase"
    }
)
result = response.json()
print(result["data"]["secret"])  # Save this!

The response includes an endpoint secret for verifying signatures:

{
  "success": true,
  "data": {
    "id": "12345678-abcd-1234-abcd-123456789012",
    "label": "prod",
    "url": "https://your-server.com/webhooks/vocobase",
    "enabled": true,
    "last_delivery_at": null,
    "last_delivery_status": null,
    "created_at": "2026-05-25T10:30:00.000Z",
    "updated_at": "2026-05-25T10:30:00.000Z",
    "secret": "whsec_a1b2c3d4e5f6g7h8i9j0...",
    "message": "Save this secret — it will not be shown again."
  }
}

The endpoint secret is only returned once. Store it securely in your environment variables. If you lose it, rotate the endpoint secret with POST /config/webhooks/{id}/rotate-secret.

Older integrations can continue using PUT /api/v2/config/webhook; it creates or replaces the reserved default endpoint. New integrations should use /config/webhooks.

See Webhook Setup for details on signature verification.

Configure telephony

You need at least one telephony provider to make outbound calls. Vocobase supports Twilio and MCube.

Twilio
MCube

Provide your Twilio Account SID, Auth Token, and a phone number:

curl -X PUT https://api.vocobase.com/api/v2/config/telephony/twilio \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "auth_token": "your_twilio_auth_token",
    "from_number": "+14155551234"
  }'

See Twilio Setup for the full guide.

Provide your MCube JWT token and executive number:

curl -X PUT https://api.vocobase.com/api/v2/config/telephony/mcube \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{
    "jwt_token": "your_mcube_jwt_token",
    "exe_number": "+919876543210"
  }'

See MCube Setup for the full guide.

Update your display name

Optionally set a display name for your partner account:

curl -X PUT https://api.vocobase.com/api/v2/config/display-name \
  -H "Authorization: Bearer rg_live_abc123def456ghi789jkl012" \
  -H "Content-Type: application/json" \
  -d '{ "display_name": "Acme Corporation" }'

Verify your setup

Run GET /config again to confirm everything is configured:

{
  "success": true,
  "data": {
    "name": "acme-corp",
    "display_name": "Acme Corporation",
    "status": "active",
    "webhook": {
      "configured": true,
      "url": "https://your-server.com/webhooks/vocobase",
      "secret": "****"
    },
    "webhooks": [
      {
        "id": "12345678-abcd-1234-abcd-123456789012",
        "label": "prod",
        "url": "https://your-server.com/webhooks/vocobase",
        "enabled": true,
        "last_delivery_at": null,
        "last_delivery_status": null,
        "created_at": "2026-05-25T10:30:00.000Z",
        "updated_at": "2026-05-25T10:30:00.000Z"
      }
    ],
    "telephony": {
      "twilio": {
        "configured": true,
        "account_sid": "ACxx****xxxx",
        "from_number": "+14155551234"
      },
      "mcube": {
        "configured": true,
        "exe_number": "+919876543210"
      }
    }
  }
}

Sensitive values like auth_token, jwt_token, and webhook endpoint secrets are never returned by GET /config.

Getting Started

Guides

Partner Onboarding

API Reference

Webhooks

Telephony

Configuring Your Account

Configuring Your Account

View your configuration

Set up webhooks

Configure telephony

Update your display name

Verify your setup

Next steps

Quick Start

Webhook Payloads

​Configuring Your Account

​View your configuration

​Set up webhooks

​Configure telephony

​Update your display name

​Verify your setup

​Next steps

Quick Start

Webhook Payloads

Configuring Your Account

View your configuration

Set up webhooks

Configure telephony

Update your display name

Verify your setup

Next steps