---
title: "POST create-font-variant"
method: POST
path: "create-font-variant"
---

# POST create-font-variant

`POST create-font-variant`

## Request

- Base URL: `https://design.penpot.app/api/main/methods`
- URL: `https://design.penpot.app/api/main/methods/create-font-variant`
- Auth: none declared

Upload a font variant. Font data must be provided as an `:uploads`
map (keyed by mime-type, values are upload-session UUIDs from the
chunked-upload API).

## Request body

- object
  - `teamId` string, uuid, required: UUID formatted string
  - `fontId` string, uuid, required: UUID formatted string
  - `fontFamily` string, required: not whitespace string
  - `fontWeight` '950' | '300' | '600' | '500' | '100' | '800' | '200' | '900' | '700' | '400', required
  - `fontStyle` 'normal' | 'italic', required
  - `uploads` object, required

## Changes

> 11 revisions in range; 1 not diffed.

- **2026-09-10** `d014f72adc3f`: 7 breaking, 1 warning
  - added the new required request property `fontFamily`
  - added the new required request property `fontId`
  - added the new required request property `fontStyle`
  - added the new required request property `fontWeight`
  - …4 more

[Operation history](https://skmtc.dev/penpot/apis/penpot-api/changes/create-font-variant/post.md)

---

[API](https://skmtc.dev/penpot/apis/penpot-api.md) - [All operations](https://skmtc.dev/penpot/apis/penpot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/penpot/apis/penpot-api/revisions/a195708d87bc?raw)