emailable

library3.1.0pypypi✓ verified 86d ago

Official Python wrapper for the Emailable API (email verification and deliverability). Current version: 3.1.0. Requires Python >=3.6. Releases are stable, with minor updates as needed.

communication

pip install emailable

github ↗homepage ↗

INSTALL

IMPORT

SIG · EMAILABLE

emailable

communicationpythonv3.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Client

✓ from emailable import Client

✗ from emailable.client import Client

Client is exposed at the package level, not in a submodule.

Initialize the client with your API key (set EMAILLABLE_API_KEY env var) and verify an email.

import os from emailable import Client client = Client(api_key=os.environ.get('EMAILLABLE_API_KEY', '')) response = client.verify(email='hello@example.com') print(response)

Debug

Known issues

breakingVersion 3.0.0 changed the Client initialization from positional argument to keyword argument for 'api_key'.

fix

Use Client(api_key='your_key') instead of Client('your_key').

affects: >=3.0.0

gotchaThe 'verify' method returns a dict-like object, not a simple boolean. Always check 'response.state' for deliverability.

fix

Verify with: state = response['state'] and compare against 'deliverable', 'undeliverable', 'risky', or 'unknown'.

affects: All

deprecatedThe 'verify' method with an 'ip_address' parameter is deprecated and may be removed in a future version.

fix

Remove 'ip_address' from the call; use the separate IP verification endpoint if needed.

affects: >=3.0.0

Errors

Common errors & fixes

AttributeError: module 'emailable' has no attribute 'Client'

Importing the package incorrectly (e.g., 'from emailable.client import Client') or using an older version (pre-3.0) that used a different structure.

fix

Use 'from emailable import Client' and ensure emailable >=3.0.0: pip install --upgrade emailable

TypeError: __init__() takes 1 positional argument but 2 were given

Passing the API key as a positional argument to Client() in version 3.0+.

fix

Use keyword argument: Client(api_key='your_key')

Upgrade

Version history

3.1.0latest on PyPI · released Jun 2, 2025

Audit

Dependencies

requestsrequiredHTTP client for API calls

Agent activity

42 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/emailable/emailable-python ↗

homepagehttps://github.com/emailable/emailable-python ↗