---
id: pipedream
version: "2.1.16"
license: unclear
license_treatment: unclear
maintenance: active
---

# pipedream

License: unclear · Maintenance: active · Downloads: 298.1K/mo

## What it is and what it does

Pipedream is a Python SDK that wraps the Pipedream APIs, allowing developers to programmatically interact with Pipedream workflows, actions, and apps. It handles authentication (OAuth client credentials or bearer token), automatic token refresh, and request/response serialization through Pydantic models. The library supports both synchronous and asynchronous clients built on httpx, with configurable timeouts, retries, and custom HTTP client configuration for proxies or specialized transports.

The SDK includes pagination support for list operations, exception handling for API errors, raw response access for headers and status codes, and automatic retry logic with exponential backoff on transient failures (408, 409, 429, and 5xx errors by default). It is typed and supports modern Python versions (3.10–3.15), making it suitable for both simple scripts and production integrations.

Use it for:

- Trigger or run Pipedream actions programmatically from Python applications or scheduled jobs
- Query and list Pipedream apps, actions, and triggers to build dynamic workflow management tools
- Build async-first applications that interact with Pipedream without blocking on API calls
- Integrate Pipedream into CI/CD pipelines or monitoring systems that need to invoke workflows

## Worth the install?

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

Provides a Python client library for accessing the Pipedream APIs, with support for both synchronous and asynchronous requests, automatic OAuth token management, and built-in retry logic.

Yes, with a caveat on license clarity. The package is actively maintained, has low install friction, no known vulnerabilities, and provides a well-structured, typed client for Pipedream's APIs. However, the license status is unclear in the metadata—verify the actual license (check the repository directly) before use in proprietary or license-sensitive contexts. For most development and integration use cases, it is a solid choice.

## Install

pip install pipedream
uv add pipedream
poetry add pipedream

## Installing pipedream

Before you install: Low install friction with a pure-wheel distribution. Actively maintained with a recent release (14 days ago) and a clean repository. Dependencies are minimal and well-established (httpx, pydantic, typing_extensions).

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or copyleft-sensitive projects.

Quickstart:

pip install pipedream

from pipedream import Pipedream

client = Pipedream(
    client_id="your-client-id",
    client_secret="your-client-secret",
)

client.actions.run(
    id="action-id",
    external_user_id="user-id",
)

Requires Python 3.10 or later (supports up to 3.15). OAuth credentials (client_id and client_secret) or a pre-generated bearer token must be provided.

Verify before relying:

- Specific API endpoints and resource types available through the client beyond actions and apps
- Rate limiting behavior and whether automatic retries respect Pipedream's rate-limit headers
- Whether the async client supports all the same operations as the sync client

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 298.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pipedream api client, pipedream python sdk, workflow automation api, async http client, api integration library, api-client, async-support, workflow-automation

[View on SkillFed](https://skillfed.io/packages/pipedream) · [View on PyPI](https://pypi.org/project/pipedream/)