{"id":23260,"library":"apache-airflow-providers-apprise","title":"Apache Airflow Provider for Apprise","description":"Apache Airflow provider that integrates with Apprise to send notifications via a wide variety of services (Slack, Telegram, email, etc.). Current version 2.3.3, released March 2025. Supports Airflow >=2.8.0. Patch releases monthly.","status":"active","version":"2.3.3","language":"python","source_language":"en","source_url":"https://github.com/apache/airflow/tree/main/airflow/providers/apprise","tags":["apache-airflow","apprise","notifications","provider"],"install":[{"cmd":"pip install apache-airflow-providers-apprise","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required runtime dependency for provider hooks and operators.","package":"apache-airflow","optional":true},{"reason":"Core notification library; this provider wraps Apprise calls.","package":"apprise","optional":false}],"imports":[{"note":"Correct import path for the hook.","symbol":"AppriseWebhookHook","correct":"from airflow.providers.apprise.hooks.apprise import AppriseWebhookHook"},{"note":"Correct import for the operator.","symbol":"AppriseWebhookOperator","correct":"from airflow.providers.apprise.operators.apprise import AppriseWebhookOperator"}],"quickstart":{"code":"import os\nfrom airflow.providers.apprise.operators.apprise import AppriseWebhookOperator\nfrom airflow.models import DAG\nfrom datetime import datetime\n\ndefault_args = {\n    'owner': 'airflow',\n    'start_date': datetime(2024, 1, 1),\n}\nwith DAG(dag_id='apprise_example', default_args=default_args, schedule=None, catchup=False):\n    send_notification = AppriseWebhookOperator(\n        task_id='send_notification',\n        apprise_conn_id='apprise_default',\n        message='Hello from Airflow!',\n        title='Test',\n        tag='alert',\n    )","lang":"python","description":"Basic usage: define an AppriseWebhookOperator in a DAG. Requires an Airflow connection configured with Apprise URLs."},"warnings":[{"fix":"Use `from airflow.providers.apprise.hooks.apprise import AppriseWebhookHook` instead of old contrib path.","message":"In provider version 1.x, import paths used `airflow.contrib.hooks.apprise_hook`. This was removed in 2.0. Update imports to `airflow.providers.apprise`.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Configure connection via Airflow UI or CLI: `airflow connections add apprise_default --conn-type apprise --conn-host 'slack://token-a/token-b/\\njson://localhost/custom'`. Use double newline to separate URLs.","message":"The Airflow connection must have `conn_type='apprise'` and the host field should contain one or more Apprise URLs separated by newlines. If URLs are not valid, the hook silently fails.","severity":"gotcha","affected_versions":"all"},{"fix":"Explicitly set `apprise_conn_id` to match the connection ID you created.","message":"Operator field `apprise_conn_id` defaults to 'apprise_default'. If not set correctly, notifications will not send without error.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade package: `pip install apache-airflow-providers-apprise>=2.3.0`","message":"The `tag` parameter was added in 2.3.0. In older versions, tags were not supported. If you rely on tagging, upgrade to >=2.3.0.","severity":"deprecated","affected_versions":"<2.3.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install apache-airflow-providers-apprise` and restart the Airflow webserver and scheduler.","cause":"Provider package not installed or Airflow environment not restarted after installation.","error":"No module named 'airflow.providers.apprise'"},{"fix":"Ensure Airflow >=2.8.0 and provider installed. Upgrade Airflow if needed.","cause":"Missing provider package or Airflow version too old (<2.8.0) which does not support provider-based connection types.","error":"AirflowException: Unknown connection type 'apprise'"},{"fix":"Use exactly: `from airflow.providers.apprise.hooks.apprise import AppriseWebhookHook`","cause":"Using wrong import path (e.g., from old contrib or incorrect casing).","error":"AttributeError: module 'airflow.providers.apprise.hooks.apprise' has no attribute 'AppriseWebhookHook'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}