Create custom font | Webflow Developer Documentation

curl -X POST https://api.webflow.com/v2/sites/580e63e98c9a982ac9b8b741/custom_fonts \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "fileName": "AcmeSans-Regular.woff2",
  "fileHash": "3c7d87c9575702bc3b1e991f4d3c638e",
  "fontFamily": "Acme Sans",
  "weight": 400,
  "italic": false,
  "fontDisplay": "swap"
}'

{
  "customFont": {
    "id": "66f3a1b2c4d5e6f7a8b9c0d1",
    "fontFamily": "Acme Sans",
    "format": "woff2",
    "fileName": "AcmeSans-Regular.woff2",
    "weight": 400,
    "italic": false,
    "fontDisplay": "swap",
    "axes": [
      {
        "tag": "wght",
        "min": 100,
        "max": 900,
        "defaultValue": 400,
        "name": "Weight"
      }
    ],
    "hostedUrl": "https://uploads-ssl.webflow.com/6437e21619d24aff35b2e4f2/66f3a1b2-AcmeSans-Regular.woff2"
  },
  "upload": {
    "url": "https://webflow-prod-assets.s3.amazonaws.com/",
    "fields": {
      "bucket": "string",
      "key": "6437e21619d24aff35b2e4f2/fonts/66f3a1b2c4d5e6f7a8b9c0d1-AcmeSans-Regular.woff2",
      "Policy": "string",
      "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
      "X-Amz-Credential": "string",
      "X-Amz-Date": "string",
      "X-Amz-Signature": "string",
      "Content-MD5": "string",
      "acl": "public-read",
      "Cache-Control": "max-age=31536000",
      "Content-Type": "font/woff2",
      "success_action_status": "201",
      "X-Amz-Security-Token": "string"
    },
    "expiresAt": "2026-05-06T12:15:00.000Z"
  }
}

The response includes a customFont object and an upload object. Use the upload.url and upload.fields to POST the font binary directly to S3 as multipart/form-data. The binary must go in a field named file and must be the last field in the form (an AWS S3 requirement). S3 returns 201 Created on a successful upload.

To learn more, see Custom fonts.

Required scope | sites:write

Register a custom font on a site and get a presigned S3 URL to upload the font binary. The response includes a `customFont` object and an `upload` object. Use the `upload.url` and `upload.fields` to POST the font binary directly to S3 as `multipart/form-data`. The binary must go in a field named `file` and must be the last field in the form (an AWS S3 requirement). S3 returns `201 Created` on a successful upload. To learn more, see [Custom fonts](/data/docs/custom-fonts). Required scope | `sites:write`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

Request

Information about the custom font to create

fileNamestringRequired

File name including extension. Accepted extensions are .woff2, .woff, .ttf, .otf, and .eot. Maximum 256 characters.

fileHashstringRequired

Lowercase hex MD5 hash of the font binary (exactly 32 characters)

fontFamilystringRequired

The CSS font-family name (1-256 characters). Commas are stripped server-side.

weightintegerRequired1-1000

CSS font-weight value (1-1000)

italicbooleanRequired

Whether the font is italic

fontDisplayenumRequired

CSS font-display value

Allowed values:

axeslist of objectsOptional

Variable font axes. Omit or pass an empty array for static fonts.

Response headers

LocationstringOptional

URL of the created custom font resource

Response

Font registered. Upload the binary to the presigned S3 URL in upload to complete the process.

customFontobject

A custom font uploaded to a Webflow site

uploadobject

Presigned S3 upload details. Post the font binary to url as multipart/form-data, including every key from fields plus the binary itself in a field named file. The file field must be the last field in the form.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error