Skip to main content
Use the SDK to place a test outbound call from a specific agent to a phone number. This is the same endpoint used by the Test Call button in the Dograh UI.

​
Prerequisites

  • A Dograh API key exported as DOGRAH_API_KEY
  • A published agent (you need the agent ID)
  • A configured telephony provider — see Telephony for Twilio, Vonage, and other setups

​
Place the call

from dograh_sdk import DograhClient
from dograh_sdk._generated_models import InitiateCallRequest

with DograhClient(api_key="YOUR_API_KEY") as client:
    client.test_phone_call(
        body=InitiateCallRequest(
            workflow_id=123,
            phone_number="+14155551234",
        )
    )

​
Inspect the run

Every call creates a run you can inspect afterwards. See Calls & runs for what’s tracked, or use the Runs API to list and fetch runs programmatically.

​
Bulk campaigns

For placing many calls at once (say, from a CSV), use Campaigns rather than looping over test_phone_call — campaigns handle pacing, retries, and progress tracking.