campaigner-edapi-client

A Python client library for accessing the Campaigner EDAPI.

Installation

pip install campaigner-edapi-client

Or with uv:

uv add campaigner-edapi-client

Usage

First, create a client:

from campaigner_edapi_client import AuthenticatedClient

client = AuthenticatedClient(base_url="https://edapi.campaigner.com", token="your-api-key")

Now call your endpoint and use your models:

from campaigner_edapi_client.api.campaigns import get_campaigns
from campaigner_edapi_client.types import Response

with client as client:
    campaigns = get_campaigns.sync(client=client)
    # or if you need more info (e.g. status_code)
    response: Response = get_campaigns.sync_detailed(client=client)

Or do the same thing with an async version:

async with client as client:
    campaigns = await get_campaigns.asyncio(client=client)
    response = await get_campaigns.asyncio_detailed(client=client)

Available API Modules

All endpoint functions live under campaigner_edapi_client.api:

API Pattern

Every path/method combo becomes a Python module with four functions:

All path/query params and request bodies become function arguments.

SSL Configuration

Custom certificate bundle:

client = AuthenticatedClient(
    base_url="https://edapi.campaigner.com",
    token="your-api-key",
    verify_ssl="/path/to/certificate_bundle.pem",
)

Advanced Customization

You can customize the underlying httpx.Client or httpx.AsyncClient:

from campaigner_edapi_client import AuthenticatedClient

def log_request(request):
    print(f"{request.method} {request.url}")

def log_response(response):
    print(f"{response.status_code}")

client = AuthenticatedClient(
    base_url="https://edapi.campaigner.com",
    token="your-api-key",
    httpx_args={"event_hooks": {"request": [log_request], "response": [log_response]}},
)

Building / Publishing

This package is automatically published to PyPI via GitHub Actions when the version in pyproject.toml is bumped on main. To release a new version:

1. Update version in pyproject.toml
2. Merge to main
3. The release workflow will create a git tag and publish to PyPI

For local development in another project:

uv add campaigner-edapi-client --dev --editable ../campaigner/sdk/python