dial-sdk
Official Python SDK for Dial — phone numbers, SMS, WhatsApp, and voice calls for AI agents.
Install
pip install dial-sdk
# or
uv add dial-sdk
Requires Python 3.11+.
Quickstart
The client is async. Construct it with a DialConfig, then call its methods inside an async with block:
import asyncio
from dial_sdk import DialClient, DialConfig, SendMessageParams, MakeCallParams
async def main():
async with DialClient(DialConfig(api_key="sk_live_...")) as dial:
# List your numbers
numbers = await dial.list_numbers()
from_id = numbers[0].id
# Send an SMS
await dial.send_message(SendMessageParams(
to="+15551234567",
from_number_id=from_id,
body="Hello from Dial",
))
# Place an AI voice call
call = await dial.make_call(MakeCallParams(
to="+15551234567",
from_number_id=from_id,
outbound_instruction="You are a friendly assistant confirming an appointment.",
))
print(call.id, call.status)
asyncio.run(main())
DialConfig.base_url defaults to https://api.getdial.ai. Override it for local or self-hosted setups.
Live events
Incoming messages and call transcripts stream via an async generator:
async with DialClient(DialConfig(api_key="sk_live_...")) as dial:
async with dial.new_events_connection() as events:
async for event in events:
print(event) # MessageEvent / CallEvent / CallTranscribed / ...
Client methods
| Method | Description |
|---|---|
list_numbers() |
List the phone numbers on your account |
purchase_number(params) |
Buy a new number (PurchaseNumberParams) |
set_number_properties(...) |
Update a number's nickname / inbound instruction |
send_message(params) |
Send an SMS or WhatsApp message (SendMessageParams) |
reply_to_message(message_id, *, body=None, reaction=None) |
Reply or react to a message (exactly one of body/reaction) |
list_messages(...) |
List messages, optionally filtered (contact for one conversation, search by text) |
list_contacts(...) |
One page of the numbers your lines have talked to |
list_all_contacts(...) |
Every contact, following the cursor |
make_call(params) |
Place an outbound AI voice call (MakeCallParams) |
list_calls(...) |
List calls, optionally filtered |
get_call(call_id) |
Fetch a single call |
new_events_connection() |
Open a live event stream |
Related
dial-langchain— these capabilities as LangChain tools.- Documentation
Release files for dial-sdk 0.28.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dial_sdk-0.28.0.tar.gz | 114.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dial_sdk-0.28.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 143.6 kB
Release files / dial_sdk-0.28.0.tar.gz
| Download URL | dial_sdk-0.28.0.tar.gz |
|---|---|
| Size | 114.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dac251f7bb2de2e8ee14089c1a29620b309ebbb2524fa736c6af62bbb9dd8255
|
|
BLAKE2b-256 checksum How to use checksums |
7d7303bfb4a878f8a8f6a551b9aaf5007611f3d38f67d27657edf3f581d7c487
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / dial_sdk-0.28.0-py3-none-any.whl
| Download URL | dial_sdk-0.28.0-py3-none-any.whl |
|---|---|
| Size | 28.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ecdf8c604703d9ffbc4fd09b7cbfb17e45b6e04c58b36c6266cf8ecefbbe4614
|
|
BLAKE2b-256 checksum How to use checksums |
fe1bf39537fa6fe43d6cf59d4d29789136c91bc9e4de8e1148f032dd8d2a46cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency log
