The Webflow JavaScript SDK provides convenient access to the Webflow Data API from applications written in JS.
The SDK contains typings and request builders for the Webflow Data API.
Explore the API reference documentation.
Add this dependency to your project's package.json file:
Using npm:
$ npm install webflow-apiUsing yarn
$ yarn add webflow-apiSimply import Webflow and start making calls to our API.
import { WebflowClient } from "webflow-api";
const webflow = new WebflowClient({ accessToken });
// Env. variables
// in format of string, e.g.: "639656400769508adc12fe42"
const site_id = process.env.SITE_ID;
const custom_domain_id_1 = process.env.CUSTOM_DOMAIN_ID_1;
const custom_domain_id_2 = process.env.CUSTOM_DOMAIN_ID_2;
// Sites
// List Sites
const sites = await webflow.sites.list();
// Get Site
const site = await webflow.sites.get("site_id");
// Get Custom Domains
const customDomains = await webflow.sites.getCustomDomain(site_id);
// Publish Site
const site = await webflow.sites.publish(site_id, {
customDomains: [custom_domain_id_1, custom_domain_id_2],
publishToWebflowSubdomain: true,
});To implement OAuth, you'll need to register a Webflow App in your Workspace
The first step in OAuth is to generate an Authorization URL. Use this URL to fetch your Authorization Code. See the docs for more details.
import { WebflowClient } from "webflow-api";
const authorizeUrl = WebflowClient.authorizeURL({
state: "your_state",
scope: "sites:read",
clientId: "your_client_id",
redirectUri: "your_redirect_uri",
});
console.log(authorizeUrl);Use the getAccessToken function and pass in your client_id,
client_secret, and authorization_code.
import { WebflowClient } from "webflow-api";
const accessToken = WebflowClient.getAccessToken({
clientId: "your_client_id",
clientSecret: "your_client_secret",
code: "your_authorization_code"
});Instantiate the client using your access_token.
import { WebflowClient } from "webflow-api";
const webflow = WebflowClient({ accessToken });All of the types are nested within the Webflow namespace. Let IntelliSense
guide you!
All errors thrown by the SDK will be subclasses of WebflowError.
import { WebflowClient, Webflow } from 'webflow';
const webflow = new WebflowClient({ accessToken: 'your_access_token' });
try {
const sites = await webflow.sites.get(...);
} catch (e) {
if (e instanceof Webflow.ForbiddenError) {
console.log(e.body.message);
} else if (e instanceof Webflow.BadRequestError) {
console.log(e.body.message);
} else {
throw e;
}
}By default, requests time out after 60 seconds. You can configure the timeout and # of max retries
import { WebflowClient } from 'webflow';
const sites = await webflow.sites.get(..., {
timeoutInSeconds: 30 // override the timeout
});The SDK will automatically retry failures with exponential backoff. You can configure the retries by setting maxRetries.
import { WebflowClient } from 'webflow';
const sites = await webflow.sites.get(..., {
maxRetries: 10 // override the retries
});This SDK is in Preview, and there may be breaking changes between versions without a major version update.
To ensure a reproducible environment (and minimize risk of breaking changes), we recommend pinning a specific package version.
While we value open-source contributions to this SDK, this library is generated programmatically. Additions made directly to this library would have to be moved over to our generation code, otherwise they would be overwritten upon the next generated release. Feel free to open a PR as a proof of concept, but know that we will not be able to merge it as-is. We suggest opening an issue first to discuss with us!
On the other hand, contributions to the README are always very welcome!