---
id: azure-communication-email
version: "1.1.0"
license: MIT License
license_treatment: permissive
maintenance: active
---

# azure-communication-email — Microsoft Azure MyService Management Client Library for Python

License: permissive · Maintenance: active · Downloads: 3.8M/mo

## What it is and what it does

This is the official Python SDK for sending emails through Azure Communication Services. It wraps the Azure email API, letting you construct and dispatch messages with support for multiple recipient types (to, cc, bcc), file attachments, and inline content references. The client handles authentication via connection string, Azure Active Directory, or API key credentials, and provides a poller-based interface to track send status asynchronously.

You define messages as dictionaries specifying subject, body (plain text and/or HTML), recipients, sender address, and optional attachments with base64-encoded content. The package depends on azure-core for HTTP transport and credential handling, isodate for date parsing, and typing-extensions for type hints. It targets modern Python versions (3.9–3.13) and is maintained as part of the broader Azure SDK ecosystem.

Use it for:

- Send transactional emails (password resets, order confirmations) from a Python application integrated with Azure.
- Dispatch bulk marketing or notification emails to multiple recipients with cc/bcc support.
- Attach files or embed inline images in emails programmatically without managing SMTP infrastructure.
- Integrate email delivery into an Azure-hosted microservice or serverless function.
- Track email send status asynchronously using the returned poller object.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Sends emails via Azure Communication Services, supporting multiple recipients, attachments, and inline content through a Python client library.

Yes, if you are already using Azure and need to send email from Python. The package is production-stable, actively maintained, has no known vulnerabilities, and integrates cleanly with Azure authentication and infrastructure. Install only if you have an Azure Communication Service resource set up; it is not suitable for standalone SMTP or third-party email providers.

## Install

pip install azure-communication-email
uv add azure-communication-email
poetry add azure-communication-email

## Installing azure-communication-email

Before you install: Low friction install with three lightweight runtime dependencies (isodate, azure-core, typing-extensions). Active maintenance with recent release (301 days ago) and ongoing repository activity.

License in practice: MIT License permits commercial and private use with minimal restrictions—you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart:

pip install azure-communication-email

from azure.communication.email import EmailClient

connection_string = "endpoint=https://<resource>.communication.azure.com/;accessKey=<key>"
client = EmailClient.from_connection_string(connection_string)
message = {"content": {"subject": "Test", "plainText": "Body"}, "recipients": {"to": [{"address": "user@example.com"}]}, "senderAddress": "sender@contoso.com"}
poller = client.begin_send(message)
result = poller.result()

Requires an active Azure Communication Service resource with an Email Communication Resource and verified sender domain configured in Azure.

Verify before relying:

- Whether the package supports custom SMTP configuration or only Azure-hosted email services.
- Rate limits and throughput guarantees for bulk email operations.
- Retry behavior and delivery guarantees for failed send attempts.

## Package facts

- License: MIT License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure email client, send emails azure, azure communication services, email api python, bulk email sender, email with attachments, azure sdk email, azure-sdk, email-delivery, cloud-services

[View on SkillFed](https://skillfed.io/packages/azure-communication-email) · [View on PyPI](https://pypi.org/project/azure-communication-email/)