instantlyai-python-sdk
instantlyai
A typed, importable Python client for the Instantly.ai V2 API.
- A clean, resource-based client:
client.campaigns.list(...),client.leads.create(...). - Full end-to-end typing, generated from Instantly’s OpenAPI spec – real editor and type-checker support.
- Sync and async clients from a single codebase (
Instantly/AsyncInstantly). - Typed exceptions, auto-retry with backoff, and auto-paginating list methods.
Status: pre-1.0 (
0.x). Minor version bumps may include breaking changes until1.0.0– pin accordingly. See the changelog.
Install
pip install instantlyai
Quickstart
Set INSTANTLY_API_KEY in your environment, or pass api_key=... explicitly.
"""Quickstart: authenticate and list your campaigns.
Runnable as-is once ``INSTANTLY_API_KEY`` is set in the environment. Also
executed in CI (see ``tests/test_examples.py``) against a mocked API, so this
file can never drift from what actually works.
"""
from __future__ import annotations
import instantlyai
def main(client: instantlyai.Instantly) -> None:
for campaign in client.campaigns.list(limit=10):
print(campaign.id, campaign.name)
if __name__ == "__main__":
with instantlyai.Instantly() as client: # reads INSTANTLY_API_KEY from the environment
main(client)
Async usage is the same shape, with AsyncInstantly and await/async for.
Docs
Full documentation, including the tutorial and API reference, lives at https://exprtec.github.io/instantlyai-python-sdk.
Contributing
See CONTRIBUTING.md.