---
title: "Create a new custom card"
method: POST
path: "/cards/createCustomCard"
tags: ["customizer"]
---

# Create a new custom card

`POST /cards/createCustomCard`

## Request body

- object
  - `uid` string — authorized UID of the session.
  - `card_id` integer — the card id of the card template you're starting with. You can find this by logging into Handwrytten, clicking "customize" next to any customizable card, and pulling the card ID from the end of the URL
  - `name` string — the name of the new card
  - `type` string — Defines the top of the back of the card. Set to either "logo" or "text".
  - `logo_id` integer — Optional. If setting "type" to "logo", set the id of the logo here.
  - `header_align` string — set to "left", "center", or "right" to align the header appropriately
  - `header_text` string — text in the header, if type is set to "text"
  - `header_font_id` integer — font ID of the text in the header, found by using ListFontForCustomizer
  - `header_font_size` integer — font size of the text in the header of the card
  - `header_auto_size` boolean — if set to true, the header will be maximized to fill the header area
  - `footer_text` string — optional text for the footer of the customizable card
  - `footer_align` string — set to "left", "center", or "right" to align the footer appropriately
  - `footer_font_id` integer — font ID of the text in the footer, found by using ListFontForCustomizer
  - `footer_font_size` integer — Font size of the text in the footer
  - `logo_size_percent` integer — set to the desired scaling of the logo on the header
  - `cover_id` integer — the id of the image you want to use for the "cover". The cover is the large image on the front of the flat card.
  - `cover_size_percent` integer — the size of the image to use as the cover.

## Response `200`

successful operation

- object

---

[API](https://skmtc.dev/swaggerhub/apis/handwrytten-api.md) · [All operations](https://skmtc.dev/swaggerhub/apis/handwrytten-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swaggerhub/handwrytten-api/revisions/45e7c951cdd6/schema)