webflow-install-auth

# Webflow Install & Auth ## Overview Set up the official Webflow JS SDK (`webflow-api` on npm) and configure authentication using either a workspace/site API token or OAuth 2.0 for Data Client Apps. ## Prerequisites - Node.js 18+ - npm, pnpm, or yarn - A Webflow account with a workspace - An API token (workspace or site) from `https://developers.webflow.com` ## Instructions ### Step 1: Install the SDK ```bash # npm npm install webflow-api # pnpm pnpm add webflow-api # yarn yarn add webflow-api ``` The package is `webflow-api` (not `@webflow/sdk`). Current version: 3.x (Data API v2). ### Step 2: Choose Authentication Method Webflow offers two auth methods: | Method | Use Case | Scope | |--------|----------|-------| | **API Token** (workspace) | Server-side scripts, internal tools | All sites in workspace | | **API Token** (site) | Single-site integrations | One site only | | **OAuth 2.0** | Public apps, Webflow Marketplace apps | User-authorized scopes | ### Step 3: Token-Based Authentication ```bash # Set environment variable (never hardcode tokens) echo 'WEBFLOW_API_TOKEN=your-token-here' >> .env echo '.env' >> .gitignore ``` ```typescript import { WebflowClient } from "webflow-api"; // Initialize with workspace or site token const webflow = new WebflowClient({ accessToken: process.env.WEBFLOW_API_TOKEN!, }); ``` ### Step 4: OAuth 2.0 Flow (Data Client Apps) For apps that need user authorization, implement the OAuth 2.0 authorization code flow: ```types...