azure-communication-email

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 on this page — 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

azure-communication-email on PyPI

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

Evidence: azure_communication_email-1.1.0-py3-none-any.whl

Keywords: azure, azure sdk

Tags

More Internet packages