---
title: "Create a new font"
method: POST
path: "/api/v1/fonts"
tags: ["Fonts"]
---

# Create a new font

`POST /api/v1/fonts`

## Request

- Base URL: `https://api.sudomock.com`
- URL: `https://api.sudomock.com/api/v1/fonts`
- Auth: API key in header `x-api-key`

Upload a custom TTF or OTF font (Pro plan and above). Send either a multipart 'file' or a JSON body with a public 'url'. The font is validated and security-checked before it is stored.

## Request body

- object: JSON body for POST /api/v1/fonts when uploading a font by URL. The alternative is a multipart 'file' upload. Send one or the other.
  - `url` string, required: Public URL of a TTF or OTF font file to fetch
  - `license_confirmed` boolean: Confirmation that you have the right to use and embed this font. Required.

## Response `201`

Successful Response

- FontResponse: A single font in the catalog: a shared system font, or one of the caller's own uploaded fonts.
  - `uuid` string, required: Font id
  - `family` string, required: Font family name, e.g. 'Open Sans'
  - `subfamily` string, nullable: Style within the family, e.g. 'Bold Italic'
  - `postscript_name` string, required: PostScript name, the stable key used to reference this font when rendering text layers
  - `category` string, nullable: Catalog category, e.g. 'sans-serif', 'serif', 'display'
  - `license` string, nullable: License identifier (system fonts)
  - `is_premium` boolean: Whether this is a premium catalog font
  - `is_system` boolean, required: True for the shared system catalog, False for a font you uploaded
  - `preview_url` string, nullable: Legacy rendered preview image, when available; new catalog entries no longer include one (use file_url for live previews)
  - `file_url` string, nullable: URL of the web-optimized WOFF2 file for live @font-face preview: a public CDN URL for system fonts, a short-lived link for your own uploads. Null for premium fonts; the original TTF/OTF source is never exposed.
  - `created_at` string, nullable: When the font was added

---

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