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 (`number_id` for one line's)
`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
`stop_call(call_id)`	Cancel a queued/ringing call, or hang up one in progress
`new_events_connection()`	Open a live event stream

dial-langchain — these capabilities as LangChain tools.
Documentation

Metadata

Release files for dial-sdk 0.40.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dial-sdk 0.40.0
File	Size	Uploaded
dial_sdk-0.40.0.tar.gz	119.0 kB	Oct 6, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dial-sdk 0.40.0
File	Interpreter	ABI	Platform	Reset
dial_sdk-0.40.0-py3-none-any.whl 31.3 kB Oct 6, 2026	Python 3	none	any	Details

Total release size: 150.3 kB

Release files / dial_sdk-0.40.0.tar.gz

Download URL	dial_sdk-0.40.0.tar.gz
Size	119.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`a6ecaac7b3d9a8110af9c145a32864f85b0ce6e652f41944dfe60a7a5ffe7221`
BLAKE2b-256 checksum How to use checksums	`ef0259e139fad9eab88755bd31492cef73b7ff109cf3a6a9d8032de67ed549e7`
Upload date	Oct 6, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/GENWAY-AI/dial
Publishing commit: github.com/GENWAY-AI/dial/tree/2abd667f8fa6a6cd2e45f91d3d700459b2958bdb

Workflow

Publishing configuration: github.com/GENWAY-AI/dial/blob/2abd667f8fa6a6cd2e45f91d3d700459b2958bdb/.github/workflows/publish-sdk-python.yml
Publishing logs: github.com/GENWAY-AI/dial/actions/runs/37451111511/attempts/1

Artifact

Subject: dial_sdk-0.40.0.tar.gz
SHA-256 checksum: a6ecaac7b3d9a8110af9c145a32864f85b0ce6e652f41944dfe60a7a5ffe7221 Verifying attestations

Release files / dial_sdk-0.40.0-py3-none-any.whl

Download URL	dial_sdk-0.40.0-py3-none-any.whl
Size	31.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7bd0a7699ab4bef391d3ceb9e3989252195e40a634db8b557df5ef23a2391047`
BLAKE2b-256 checksum How to use checksums	`bf37e29ad65df9eb8a47bb55c3d9d5c81ac1aff12103afe59f1a204623d4ac28`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/GENWAY-AI/dial
Publishing commit: github.com/GENWAY-AI/dial/tree/2abd667f8fa6a6cd2e45f91d3d700459b2958bdb

Workflow

Publishing configuration: github.com/GENWAY-AI/dial/blob/2abd667f8fa6a6cd2e45f91d3d700459b2958bdb/.github/workflows/publish-sdk-python.yml
Publishing logs: github.com/GENWAY-AI/dial/actions/runs/37451111511/attempts/1

Artifact

Subject: dial_sdk-0.40.0-py3-none-any.whl
SHA-256 checksum: 7bd0a7699ab4bef391d3ceb9e3989252195e40a634db8b557df5ef23a2391047 Verifying attestations