growthctl 0.1.3

Marketing as Code - Manage ad campaigns like infrastructure

growthctl

Marketing as Code CLI for managing ad campaigns declaratively using YAML and Git.

Note: This project is currently in active development. APIs and configuration schemas are subject to change.

Plan and apply campaign changes safely with Terraform-style dry runs. Version control your ad strategy and collaborate using standard Git workflows. Manage Meta (Facebook/Instagram) ads with built-in provider support.

Table of Contents

• Install
• Usage
• Contributing
• License

Install

Install using uv (recommended):

uv tool install growthctl

Install using pipx:

pipx install growthctl

Or using pip:

pip install growthctl

Usage

Define your campaign in campaign.yaml:

version: "1.0"
campaigns:
  - id: summer-sale
    name: Summer Sale 2026
    objective: OUTCOME_SALES
    status: ACTIVE
    ad_sets:
      - id: us-audience
        name: US Audience
        status: ACTIVE
        budget_daily: 5000
        targeting:
          locations: ["US"]
          age_min: 25
          age_max: 54

Preview and apply changes:

# Preview changes
growthctl plan campaign.yaml

# Apply to live
growthctl apply campaign.yaml

Contributing

See the contributing file for details.

License

MIT © growthctl contributors

Contact

For questions or feedback, please reach out to [e-mail].