Airflow Summit 2025 is coming October 07-09. Register now to secure your spot!

apache-airflow-providers-smtp

Changelog

2.3.1

Release Date: 2025-09-28

Bug Fixes

  • Fix import for SMTP provider (#56053)

2.3.0

Release Date: 2025-09-22

Features

  • Add Async support for SMTP Notifier (#55308)

2.2.1

Release Date: 2025-09-09

Bug Fixes

  • Fix SMTP email template when mark_success_url is undefined for RuntimeTaskInstance objects (#54680)

Doc-only

  • Make term Dag consistent in providers docs (#55101)

2.2.0

Release Date: 2025-08-11

Features

  • Add OAuth 2 / XOAUTH2 support via 'auth_type' & token/credential extras (#53554)

2.1.2

Release Date: 2025-08-02

Bug Fixes

  • Fix: enter SmtpHook before trying to read properties (#53418)

Misc

  • Add Python 3.13 support for Airflow. (#46891)

  • Cleanup type ignores in smtp provider where possible (#53260)

  • Remove type ignore across codebase after mypy upgrade (#53243)

  • Remove upper-binding for "python-requires" (#52980)

  • Temporarily switch to use >=,< pattern instead of '~=' (#52967)

  • Moving BaseHook usages to version_compat for smtp (#52950)

2.1.1

Release Date: 2025-07-06

Misc

  • Move 'BaseHook' implementation to task SDK (#51873)

  • Provider Migration: Replace 'models.BaseOperator' to Task SDK for 'smtp' (#52596)

  • Drop support for Python 3.9 (#52072)

2.1.0

Release Date: 2025-05-18

Note

This release of provider is only available for Airflow 2.10+ as explained in the Apache Airflow providers support policy <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#minimum-supported-version-of-airflow-for-community-managed-providers>_.

Misc

  • Remove AIRFLOW_2_10_PLUS conditions (#49877)

  • Bump min Airflow version in providers to 2.10 (#49843)

2.0.3

Release Date: 2025-04-19

Misc

  • remove superfluous else block (#49199)

2.0.2

Release Date: 2025-03-31

Misc

  • Move BaseNotifier to Task SDK (#48008)

2.0.1

Release Date: 2025-03-13

Misc

  • Upgrade flit to 3.11.0 (#46938)

2.0.0

Release Date: 2025-02-26

Breaking changes

Warning

The argument from_email is now an optional kwarg in SmtpNotifier, and the argument to became the first positional argument.

Configuring the SmtpNotifier and SmtpHook default values via Airflow SMTP configurations is not supported anymore. You can instead use the SMTP connection configuration to set the default values, where you can use:

  • the connection extra field ssl_context instead of the configuration smtp_provider.ssl_context or email.ssl_context in the SMTP hook.

  • the connection extra field from_email instead of the configuration smtp.smtp_mail_from in SmtpNotifier.

  • the connection extra field subject_template instead of the configuration smtp.templated_email_subject_path in SmtpNotifier.

  • the connection extra field html_content_template instead of the configuration smtp.templated_html_content_path in SmtpNotifier.

  • Replace Airflow email config by connection extras in SMTP provider (#46219)

Features

  • feat(smtp): support html_content and subject templates from SMTP connection (#46212)

Misc

  • AIP-72: Support better type-hinting for Context dict in SDK  (#45583)

1.9.0

Release Date: 2024-12-26

Note

This release of provider is only available for Airflow 2.9+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers to Airflow 2.9.0 (#44956)

1.8.1

Release Date: 2024-11-18

Misc

  • Move bash operator to Standard provider (#42252)

  • Purge existing SLA implementation (#42285)

  • Unify DAG schedule args and change default to None (#41453)

1.8.0

Release Date: 2024-08-22

Note

This release of provider is only available for Airflow 2.8+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers to Airflow 2.8.0 (#41396)

1.7.1

Release Date: 2024-05-30

Misc

  • Faster 'airflow_version' imports (#39552)

  • Simplify 'airflow_version' imports (#39497)

1.7.0

Release Date: 2024-05-06

Note

This release of provider is only available for Airflow 2.7+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers to Airflow 2.7.0 (#39240)

1.6.1

Release Date: 2024-03-08

Bug Fixes

  • Fix backwards compatibility for SMTP provider (#37701)

Misc

  • Deprecate smtp configs in airflow settings / local_settings (#37711)

1.6.0 (YANKED)

Warning

This release has been yanked with a reason: The release had broken backwards compatibility with Airflow 2.8.* release

Features

  • Modify SmtpNotifier to accept template with defaults (#36226)

Bug Fixes

  • Follow BaseHook connection fields method signature in child classes (#36086)

1.5.0

Release Date: 2023-12-12

Note

This release of provider is only available for Airflow 2.6+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers to Airflow 2.6.0 (#36017)

1.4.1

Release Date: 2023-10-31

Misc

  • Make 'cc' and 'bcc' templated fields in EmailOperator (#35235)

1.4.0

Release Date: 2023-10-17

Note

This release of provider is only available for Airflow 2.5+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump min airflow version of providers (#34728)

1.3.2

Release Date: 2023-09-12

Misc

  • Refactor unneeded  jumps in providers (#33833)

  • Improve modules import in Airflow providers by some of them into a type-checking block (#33754)

1.3.1

Release Date: 2023-08-29

Bug Fixes

  • Simplify 'X for X in Y' to 'Y' where applicable (#33453)

1.3.0

Release Date: 2023-08-08

In case of SMTP SSL connection, the default context now uses “default” context

The “default” context is Python’s default_ssl_context instead of previously used “none”. The default_ssl_context provides a balance between security and compatibility but in some cases, when certificates are old, self-signed or misconfigured, it might not work. This can be configured by setting “ssl_context” in “smtp_provider” configuration of the provider. If it is not explicitly set, it will default to “email”, “ssl_context” setting in Airflow.

Setting it to “none” brings back the “none” setting that was used in previous versions of the provider, but it is not recommended due to security reasons ad this setting disables validation of certificates and allows MITM attacks.

You can also override “ssl_context” per-connection by setting “ssl_context” in the connection extra.

Features

  • Add possibility to use 'ssl_context' extra for SMTP and IMAP connections (#33112)

  • Allows to choose SSL context for SMTP provider (#33075)

1.2.0

Release Date: 2023-06-23

Note

This release dropped support for Python 3.7

Features

  • Add notifier for Smtp (#31359)

1.1.0

Release Date: 2023-05-22

Note

This release of provider is only available for Airflow 2.4+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers (#30917)

1.0.1

Release Date: 2023-04-12

Bug Fixes

  • 'EmailOperator': fix wrong assignment of 'from_email' (#30524)

  • Accept None for 'EmailOperator.from_email' to load it from smtp connection (#30533)

1.0.0

Release Date: 2023-04-06

Initial version of the provider.

Was this entry helpful?