---
id: webflow
version: "2.0.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# webflow

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

## What it is and what it does

Webflow is a typed Python client for Webflow's Data API, wrapping REST endpoints for managing sites, collections, items, and user data. It ships with both synchronous and asynchronous clients powered by httpx, full Pydantic type definitions for all request and response fields, and built-in OAuth support for app-based authentication.

The library is generated programmatically from Webflow's API specification, meaning it stays in sync with the API but also means direct code contributions are not merged as-is. It supports Python 3.8 through 3.15, has low install friction (four lightweight dependencies), and includes exception handling via subclasses of ApiError. The SDK is marked as Preview, so version pinning is advised to avoid unexpected breaking changes.

Use it for:

- Automate site and collection management in Webflow programmatically from Python applications.
- Build OAuth-authenticated apps that integrate with Webflow workspaces without hardcoding tokens.
- Fetch and update Webflow collection items in bulk using the async client for non-blocking I/O.
- Handle Webflow API errors gracefully with specific exception types for different error conditions.
- Customize HTTP behavior (proxies, transports, timeouts) by passing a custom httpx.Client instance.

## Worth the install?

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

A Python client library for the Webflow Data API, offering synchronous and asynchronous interfaces with full type definitions for requests and responses.

Yes, if you are building against the Webflow Data API. The library is actively maintained, has low install friction, includes full type coverage, and offers both sync and async interfaces. Pin a specific version to guard against Preview-status breaking changes. No known vulnerabilities.

## Install

pip install webflow
uv add webflow
poetry add webflow

## Installing webflow

Before you install: Low friction: pure Python wheel with only four runtime dependencies (httpx, pydantic, pydantic-core, typing_extensions). Actively maintained with recent commits; however, the SDK is in Preview status, so breaking changes between versions are possible without major version bumps—pinning a specific version is recommended.

License in practice: MIT license (permissive) allows commercial and private use with minimal restrictions, making it safe for most projects.

Quickstart:

pip install webflow

from webflow.client import Webflow

client = Webflow(access_token="YOUR_ACCESS_TOKEN")
site = client.sites.get("site-id")

Requires a valid Webflow access token; obtain one via OAuth or from your Webflow account settings.

Verify before relying:

- Whether the Preview status implies active breaking changes in practice or is a conservative disclaimer.
- Rate limits and throttling behavior of the underlying Webflow Data API.
- Coverage of all Webflow Data API endpoints or whether some are missing from the SDK.

## Package facts

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

## Tags

webflow api client python, webflow data api sdk, async webflow client, webflow rest api python, webflow site management api, webflow oauth python, typed webflow sdk, api-client, async-support, oauth

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