---
id: apache-airflow-providers-facebook
version: "3.9.5"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# apache-airflow-providers-facebook — Provider package apache-airflow-providers-facebook for Apache Airflow

License: permissive · Maintenance: active · Downloads: 227.1K/mo

## What it is and what it does

This is an Apache Airflow provider package that bridges Airflow workflows with Facebook's advertising platform. It supplies operators, hooks, and sensors built on the facebook-business SDK, allowing you to orchestrate tasks like querying ad performance, managing campaigns, or syncing audience data as part of larger data pipelines. The package is maintained as part of the official Apache Airflow ecosystem and integrates cleanly with Airflow's task scheduling and dependency management.

You install it alongside an existing Airflow instance (>=2.11.0) and use its components to define DAG tasks that interact with Facebook Ads. It requires the facebook-business library (>=22.0.0) to communicate with Facebook's APIs and supports Python 3.10 through 3.14. No known security vulnerabilities are recorded.

Use it for:

- Schedule daily or hourly extraction of Facebook ad performance metrics into a data warehouse
- Automate campaign pause/resume logic based on budget thresholds or KPI triggers
- Sync Facebook audience segments with downstream analytics or CRM systems on a regular cadence
- Monitor ad account health and alert on anomalies as part of a larger observability workflow

## Worth the install?

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

Integrates Apache Airflow with Facebook Ads, enabling scheduled workflows to interact with Facebook's advertising platform through the facebook-business SDK.

Yes, if you run Apache Airflow and need to automate Facebook Ads workflows. The package is actively maintained, carries no security vulnerabilities, uses a permissive license, and installs with low friction. Install it only if you have Airflow >=2.11.0 already in place and a concrete use case for Facebook Ads automation; otherwise it adds unnecessary dependencies.

## Install

pip install apache-airflow-providers-facebook
uv add apache-airflow-providers-facebook
poetry add apache-airflow-providers-facebook

## Installing apache-airflow-providers-facebook

Before you install: Low friction installation as a wheel. Active maintenance with recent release (68 days ago); the parent Apache Airflow project has strong community backing (46490 stars). Requires apache-airflow >=2.11.0 and facebook-business >=22.0.0.

License in practice: Apache License 2.0 (permissive) allows commercial use, modification, and distribution with minimal restrictions—standard for Apache projects and poses no licensing barrier to adoption.

Quickstart:

pip install apache-airflow-providers-facebook

from airflow.providers.facebook.operators.facebook_ads_insights import FacebookAdsInsightsOperator
from airflow import DAG

# Use FacebookAdsInsightsOperator in a DAG to query ad insights

Requires an existing Apache Airflow >=2.11.0 installation and valid Facebook Ads API credentials (access token, ad account ID)

Verify before relying:

- Specific operators, hooks, or sensor types available in this provider version
- Whether facebook-business >=22.0.0 requires system-level dependencies or authentication setup
- Scope of Facebook Ads features supported (e.g., campaign creation, reporting, audience management)

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 227.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

airflow facebook ads integration, schedule facebook campaigns, facebook ads workflow automation, airflow provider facebook, facebook business api airflow, automated facebook ad management, airflow-provider, facebook-ads, workflow-automation

[View on SkillFed](https://skillfed.io/packages/apache-airflow-providers-facebook) · [View on PyPI](https://pypi.org/project/apache-airflow-providers-facebook/)