v1

latestSwagger 2.02026-07-13301635.0 KB
customizer

Create a new custom card

post/cards/createCustomCard

Request body

uidstring

authorized UID of the session.

card_idinteger

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

namestring

the name of the new card

typestring

Defines the top of the back of the card. Set to either "logo" or "text".

logo_idinteger

Optional. If setting "type" to "logo", set the id of the logo here.

header_alignstring

set to "left", "center", or "right" to align the header appropriately

header_textstring

text in the header, if type is set to "text"

header_font_idinteger

font ID of the text in the header, found by using ListFontForCustomizer

header_font_sizeinteger

font size of the text in the header of the card

header_auto_sizeboolean

if set to true, the header will be maximized to fill the header area

footer_textstring

optional text for the footer of the customizable card

footer_alignstring

set to "left", "center", or "right" to align the footer appropriately

footer_font_idinteger

font ID of the text in the footer, found by using ListFontForCustomizer

footer_font_sizeinteger

Font size of the text in the footer

logo_size_percentinteger

set to the desired scaling of the logo on the header

cover_idinteger

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_percentinteger

the size of the image to use as the cover.

Example request

{
  "uid": "fhqwfuihuifqwhiuwqfhiqwfh124",
  "card_id": 243,
  "name": "my custom card design",
  "type": "logo",
  "logo_id": 20,
  "header_align": "center",
  "header_text": "Sample text for the header",
  "header_font_id": 8,
  "header_font_size": 20,
  "footer_text": "Sample text for the footer",
  "footer_align": "center",
  "footer_font_id": 1,
  "footer_font_size": 16,
  "logo_size_percent": 100,
  "cover_id": 42,
  "cover_size_percent": 100
}

Response

successful operation

object required