Thankster

App · 17 actions

Send real cards with handwritten-style messages by mail: mail a card from one of your Thankster templates, or build, preview and order one step by step, and keep your address book up to date.

Actions

ActionWhat it does
Add a contact to the address bookAdd a contact to a Thankster user's address book.
Approve an order for printingApprove an order so Thankster prints and mails it.
Change card designSwap the printed card design of a card draft.
Change the handwritingChange the handwriting font, size, ink color or line angle on a card draft.
Create a card draftStart a card for one recipient from a template, without ordering it.
Find or create a userFind the Thankster user with this email, or create one, and set their mailing address, which goes on their envelopes as the return address.
List address book contactsList the contacts in your Thankster address book.
List card categoriesList the categories Thankster files its card designs under.
List card designsList Thankster's card designs, from every category or one, with their sizes.
List handwriting fontsList the handwriting fonts a card can be written in.
List templatesList the card templates saved in your Thankster account (My Templates), with their ids.
Order a card draftPlace the order for a finished card draft.
Preview a cardGet pictures of a card draft's pages as Thankster will print them, to check before ordering.
Rename a card draftRename a card draft, as it shows in Thankster.
Send a cardMail a real card with handwritten-style messages, made from one of your Thankster templates.
Set card imagesPut pictures from web addresses into the image boxes of a card draft's template, such as a logo, photo or signature.
Set card messagesWrite the handwritten messages into the text boxes of a card draft's template.

Add a contact to the address book

Add a contact to a Thankster user's address book. Adding the same contact twice makes two entries.

Inputs

Account emailaccount_emailtextRequired
The email of the Thankster account whose address book gets the contact, usually your own sign in email.
First namefirst_nametextRequired
The first name, as it goes on the envelope.
Last namelast_nametext
The last name.
Companycompanytext
A company name for the envelope, if any.
Street addressaddresstextRequired
The street address, such as 123 Main St.
Address line 2address2text
Apartment, suite or unit, if any.
CitycitytextRequired
The city or town.
Statestatetext
For a US address, the state's two-letter code (CA) or its name (California). Elsewhere, the region or province.
ZIP codezip_codetextRequired
The ZIP or postal code. A US ZIP code that lost its leading zero (6815) gets it back.
Countrycountrytext
The two-letter country code, such as US, CA or GB. Defaults to US. Thankster charges more to mail outside the US.Default: US.
Emailemailtext
The email address, kept with the address in Thankster.

Outputs

account_emailtext
Whose address book it went into
addednumber
How many contacts were added (1)
messagetext
Thankster's own words about it
nametext
The contact's name as sent
Example output
{
  "account_email": "johnboy@thankster.com",
  "added": 1,
  "message": "Addressbook entries successfully imported",
  "name": "Bob Martin"
}

Approve an order for printing

Approve an order so Thankster prints and mails it. Thankster then bills it to your plan. It can't be undone here and is never retried.

Inputs

Order IDorder_idtextRequired
The order, from 'Order a card draft' (its order_id).
Your order referenceyour_order_idtext
Your own reference for the order, such as an order number from your shop, kept by Thankster. Defaults to lodol- and the order ID.

Outputs

approvedtrue/false
Always true: Thankster approved it
messagetext
Thankster's own words about it
order_idtext
The order approved
your_order_idtext
The reference sent with it
Example output
{
  "approved": true,
  "message": "Successfully approved order for Printing",
  "order_id": "123",
  "your_order_id": "testorder123"
}

Change card design

Swap the printed card design of a card draft.

Inputs

Thankster user IDthankster_user_idtextRequired
The Thankster user the card belongs to, from 'Find or create a user' or 'Create a card draft'.
Card draft IDproject_idtextRequired
The card draft, from 'Create a card draft' (its project_id).
Card designdesign_idtextRequired
The new design. Pick one, or give its id from 'List card designs'.

Outputs

design_idtext
The design it now uses
messagetext
Thankster's own words about it
project_idtext
The card draft that was changed
Example output
{
  "design_id": "12875",
  "message": "Card selection saved",
  "project_id": "7875"
}

Change the handwriting

Change the handwriting font, size, ink color or line angle on a card draft. Only the settings filled in change.

Inputs

Thankster user IDthankster_user_idtextRequired
The Thankster user the card belongs to, from 'Find or create a user' or 'Create a card draft'.
Recipient IDrecipient_idtextRequired
The card's recipient, from 'Create a card draft' (its recipient_id).
Fontfont_idtext
The handwriting font. Pick one, or give its id from 'List handwriting fonts'.
Font sizefont_sizenumber
How large the writing is, from 1 to 100.From 1 to 100.
Ink colorfont_colortext
The ink color as a hex code, such as #1F3A93 for blue or #000000 for black.
Line angleline_anglenumber
How the lines slope, from 1 to 100. 50 keeps them level.From 1 to 100.

Outputs

changedlist
What changed: font, font size, ink color, line angle
font_colortext
The ink color set, empty if unchanged
font_idtext
The font set, empty if unchanged
font_sizenumber
The font size set, 0 if unchanged
line_anglenumber
The line angle set, 0 if unchanged
recipient_idtext
The recipient whose card was changed
Example output
{
  "changed": [
    "font",
    "font size",
    "ink color",
    "line angle"
  ],
  "font_color": "#1F3A93",
  "font_id": "523",
  "font_size": 50,
  "line_angle": 50,
  "recipient_id": "7875"
}

Create a card draft

Start a card for one recipient from a template, without ordering it. Set its messages, images, design and handwriting next, then order it. Nothing is billed for a draft.

Inputs

Templatetemplate_idtextRequired
The card template, saved under My Templates in Thankster. It sets the card design, handwriting and default messages. Pick one, or give its id from 'List templates'.
Thankster user IDthankster_user_idtextRequired
The Thankster user the card belongs to, from 'Find or create a user' or 'Create a card draft'.
Recipient first namerecipient_first_nametextRequired
The recipient's first name, as it goes on the envelope.
Recipient last namerecipient_last_nametext
The recipient's last name.
Recipient companyrecipient_companytext
A company name for the envelope, if any.
Recipient street addressrecipient_addresstextRequired
The street address, such as 123 Main St.
Recipient address line 2recipient_address2text
Apartment, suite or unit, if any.
Recipient cityrecipient_citytextRequired
The city or town.
Recipient staterecipient_statetext
For a US address, the state's two-letter code (CA) or its name (California). Elsewhere, the region or province.
Recipient ZIP coderecipient_zip_codetextRequired
The ZIP or postal code. A US ZIP code that lost its leading zero (6815) gets it back.
Recipient countryrecipient_countrytext
The two-letter country code, such as US, CA or GB. Defaults to US. Thankster charges more to mail outside the US.Default: US.
Recipient emailrecipient_emailtext
The recipient's email address, kept with the address in Thankster.

Outputs

project_idtext
The card draft's ID (Thankster's project ID)
recipient_idtext
The recipient's ID on the draft
recipient_nametext
Who the card is addressed to
template_idtext
The template it was made from
thankster_user_idtext
The user the draft belongs to
Example output
{
  "project_id": "7875",
  "recipient_id": "12875",
  "recipient_name": "Bob Martin",
  "template_id": "5877231",
  "thankster_user_id": "7543"
}

Find or create a user

Find the Thankster user with this email, or create one, and set their mailing address, which goes on their envelopes as the return address. Returns the user ID that building a card step by step needs.

Inputs

EmailemailtextRequired
The user's email address. Thankster finds the user by it, or creates them.
First namefirst_nametextRequired
The first name, as it goes on the envelope.
Last namelast_nametext
The last name.
Companycompanytext
A company name for the envelope, if any.
Street addressaddresstextRequired
The street address, such as 123 Main St.
Address line 2address2text
Apartment, suite or unit, if any.
CitycitytextRequired
The city or town.
Statestatetext
For a US address, the state's two-letter code (CA) or its name (California). Elsewhere, the region or province.
ZIP codezip_codetextRequired
The ZIP or postal code. A US ZIP code that lost its leading zero (6815) gets it back.
Countrycountrytext
The two-letter country code, such as US, CA or GB. Defaults to US. Thankster charges more to mail outside the US.Default: US.

Outputs

addresstext
The user's address on one line, as sent
emailtext
The user's email address
nametext
The user's name as sent
thankster_user_idtext
The user's Thankster ID, for the card steps
Example output
{
  "address": "123 Road, Apartment 5F, Morgantown, WV 26508, US",
  "email": "contact@example.com",
  "name": "Bob Martin",
  "thankster_user_id": "7875"
}

List address book contacts

List the contacts in your Thankster address book.

Inputs

None.

Outputs

contactslist
The contacts
countnumber
How many contacts there are
Example output
{
  "contacts": [
    {
      "address": "123 Road",
      "address2": "Apartment 5F",
      "city": "Morgantown",
      "company": "Igicom LLC",
      "country": "US",
      "email": "contact@example.com",
      "first_name": "Bob",
      "id": "4411",
      "last_name": "Martin",
      "state": "WV",
      "zip_code": "26508"
    }
  ],
  "count": 1
}

List card categories

List the categories Thankster files its card designs under.

Inputs

None.

Outputs

categorieslist
The categories
countnumber
How many categories there are
Example output
{
  "categories": [
    {
      "id": "143",
      "name": "Thank You Cards"
    },
    {
      "id": "101",
      "name": "Business Thank Yous"
    }
  ],
  "count": 2
}

List card designs

List Thankster's card designs, from every category or one, with their sizes.

Inputs

Categorycategory_idtext
Only designs in this category. Leave empty for every design.

Outputs

category_idtext
The category asked for, empty for all
countnumber
How many designs were returned
designslist
The card designs
totalnumber
How many designs Thankster says the category has
Example output
{
  "category_id": "186",
  "count": 1,
  "designs": [
    {
      "category_id": "186",
      "height_inches": 4.25,
      "id": "1320",
      "name": "Business Red",
      "orientation": "landscape",
      "thumbnail_url": "https://app.thankster.com/thankster5/thumb/phpThumb.php?src=/template/1320/cover.jpg&w=220&h=200&q=60&zc=0&bc=ffffff",
      "width_inches": 5.5
    }
  ],
  "total": 70
}

List handwriting fonts

List the handwriting fonts a card can be written in.

Inputs

None.

Outputs

countnumber
How many fonts there are
fontslist
The fonts
Example output
{
  "count": 2,
  "fonts": [
    {
      "id": "523",
      "name": "Americana",
      "type": "handwriting"
    },
    {
      "id": "453",
      "name": "Annette",
      "type": "handwriting"
    }
  ]
}

List templates

List the card templates saved in your Thankster account (My Templates), with their ids.

Inputs

Searchsearchtext
Only templates whose name contains this.
How manylimitnumber
The most templates to return, 1 to 2000. Defaults to 100.From 1 to 2000.

Outputs

countnumber
How many templates were returned
templateslist
The templates
totalnumber
How many templates the account has that match
Example output
{
  "count": 1,
  "templates": [
    {
      "card_type": "folder_card",
      "id": "1234",
      "name": "Thank you template",
      "orientation": "landscape",
      "size": "large",
      "thumbnail_url": "https://thankster-prod.s3.amazonaws.com/thumbs/template_3.png"
    }
  ],
  "total": 1
}

Order a card draft

Place the order for a finished card draft. Nothing is printed or billed until the order is approved for printing. It is never retried.

Inputs

Thankster user IDthankster_user_idtextRequired
The Thankster user the card belongs to, from 'Find or create a user' or 'Create a card draft'.
Card draft IDproject_idtextRequired
The card draft, from 'Create a card draft' (its project_id).

Outputs

messagetext
Thankster's own words about it
order_idtext
The order's ID, for 'Approve an order for printing'
project_idtext
The card draft ordered
Example output
{
  "message": "Order placed",
  "order_id": "7875",
  "project_id": "67890"
}

Preview a card

Get pictures of a card draft's pages as Thankster will print them, to check before ordering.

Inputs

Card draft IDproject_idtextRequired
The card draft, from 'Create a card draft' (its project_id).
Pagespageslist
Which pages to picture. Defaults to the front cover; each extra page takes longer.One or more of: front (Front cover), back (Back cover), inside_one (Inside, first page (top or left)), inside_two (Inside, second page (bottom or right)), envelope. Default: ["front"].

Outputs

countnumber
How many pages were pictured
pageslist
One picture per page
project_idtext
The card draft pictured
Example output
{
  "count": 1,
  "pages": [
    {
      "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg==",
      "page": "front"
    }
  ],
  "project_id": "7502"
}

Rename a card draft

Rename a card draft, as it shows in Thankster.

Inputs

Thankster user IDthankster_user_idtextRequired
The Thankster user the card belongs to, from 'Find or create a user' or 'Create a card draft'.
Card draft IDproject_idtextRequired
The card draft, from 'Create a card draft' (its project_id).
New namenametextRequired
The name to show in Thankster, such as the recipient's.

Outputs

messagetext
Thankster's own words about it
nametext
Its new name
project_idtext
The card draft that was renamed
Example output
{
  "message": "Project name saved",
  "name": "Project for user John Doe",
  "project_id": "7875"
}

Send a card

Mail a real card with handwritten-style messages, made from one of your Thankster templates. Thankster prints and mails it within minutes and bills it to your plan, so every run sends and pays for one card. It is never retried.

Inputs

Templatetemplate_idtextRequired
The card template, saved under My Templates in Thankster. It sets the card design, handwriting and default messages. Pick one, or give its id from 'List templates'.
Recipient first namerecipient_first_nametextRequired
The recipient's first name, as it goes on the envelope.
Recipient last namerecipient_last_nametext
The recipient's last name.
Recipient companyrecipient_companytext
A company name for the envelope, if any.
Recipient street addressrecipient_addresstextRequired
The street address, such as 123 Main St.
Recipient address line 2recipient_address2text
Apartment, suite or unit, if any.
Recipient cityrecipient_citytextRequired
The city or town.
Recipient staterecipient_statetext
For a US address, the state's two-letter code (CA) or its name (California). Elsewhere, the region or province.
Recipient ZIP coderecipient_zip_codetextRequired
The ZIP or postal code. A US ZIP code that lost its leading zero (6815) gets it back.
Recipient countryrecipient_countrytext
The two-letter country code, such as US, CA or GB. Defaults to US. Thankster charges more to mail outside the US.Default: US.
Recipient emailrecipient_emailtext
The recipient's email address, kept with the address in Thankster.
Sender first namesender_first_nametextRequired
The sender's first name, as it goes on the envelope.
Sender last namesender_last_nametext
The sender's last name.
Sender companysender_companytext
A company name for the envelope, if any.
Sender street addresssender_addresstextRequired
The street address, such as 123 Main St.
Sender address line 2sender_address2text
Apartment, suite or unit, if any.
Sender citysender_citytextRequired
The city or town.
Sender statesender_statetext
For a US address, the state's two-letter code (CA) or its name (California). Elsewhere, the region or province.
Sender ZIP codesender_zip_codetextRequired
The ZIP or postal code. A US ZIP code that lost its leading zero (6815) gets it back.
Sender countrysender_countrytext
The two-letter country code, such as US, CA or GB. Defaults to US. Thankster charges more to mail outside the US.Default: US.
Sender emailsender_emailtext
The sender's email address, kept with the address in Thankster.
Message box 1text_onetext
Text for the template's message box 1 (the one with a pink border in Thankster's editor), up to 400 characters. Left empty, the template's own text stays.
Message box 2text_twotext
Text for the template's message box 2 (the one with a orange border in Thankster's editor), up to 400 characters. Left empty, the template's own text stays.
Message box 3text_threetext
Text for the template's message box 3 (the one with a blue border in Thankster's editor), up to 400 characters. Left empty, the template's own text stays.
Message box 4text_fourtext
Text for the template's message box 4 (the one with a purple border in Thankster's editor), up to 400 characters. Left empty, the template's own text stays.
Image box 1image_onetext
Web address of a PNG or JPG for the template's image box 1 (the one with a pink border in Thankster's editor), such as a logo or signature. A cover image should be at least 1500 x 1950 pixels.
Image box 2image_twotext
Web address of a PNG or JPG for the template's image box 2 (the one with a orange border in Thankster's editor), such as a logo or signature. A cover image should be at least 1500 x 1950 pixels.
Image box 3image_threetext
Web address of a PNG or JPG for the template's image box 3 (the one with a blue border in Thankster's editor), such as a logo or signature. A cover image should be at least 1500 x 1950 pixels.
Image box 4image_fourtext
Web address of a PNG or JPG for the template's image box 4 (the one with a purple border in Thankster's editor), such as a logo or signature. A cover image should be at least 1500 x 1950 pixels.

Outputs

messagetext
Thankster's own words about it
recipient_addresstext
The recipient's address on one line
recipient_nametext
Who the card is addressed to
senttrue/false
Always true: Thankster took the order
template_idtext
The template the card was made from
Example output
{
  "message": "Order being processed",
  "recipient_address": "123 Thanks Rd, Apartment 11, Stamford, CT 06815, US",
  "recipient_name": "Jane Doe",
  "sent": true,
  "template_id": "237835"
}

Set card images

Put pictures from web addresses into the image boxes of a card draft's template, such as a logo, photo or signature.

Inputs

Thankster user IDthankster_user_idtextRequired
The Thankster user the card belongs to, from 'Find or create a user' or 'Create a card draft'.
Recipient IDrecipient_idtextRequired
The card's recipient, from 'Create a card draft' (its recipient_id).
Image box 1image_onetext
Web address of a PNG or JPG for the template's image box 1 (the one with a pink border in Thankster's editor), such as a logo or signature. A cover image should be at least 1500 x 1950 pixels.
Image box 2image_twotext
Web address of a PNG or JPG for the template's image box 2 (the one with a orange border in Thankster's editor), such as a logo or signature. A cover image should be at least 1500 x 1950 pixels.
Image box 3image_threetext
Web address of a PNG or JPG for the template's image box 3 (the one with a blue border in Thankster's editor), such as a logo or signature. A cover image should be at least 1500 x 1950 pixels.
Image box 4image_fourtext
Web address of a PNG or JPG for the template's image box 4 (the one with a purple border in Thankster's editor), such as a logo or signature. A cover image should be at least 1500 x 1950 pixels.

Outputs

boxes_setlist
The boxes that were filled in, such as text_one
messagetext
Thankster's own words about it
recipient_idtext
The recipient whose card was changed
Example output
{
  "boxes_set": [
    "image_one"
  ],
  "message": "Images saved",
  "recipient_id": "5877231"
}

Set card messages

Write the handwritten messages into the text boxes of a card draft's template.

Inputs

Thankster user IDthankster_user_idtextRequired
The Thankster user the card belongs to, from 'Find or create a user' or 'Create a card draft'.
Recipient IDrecipient_idtextRequired
The card's recipient, from 'Create a card draft' (its recipient_id).
Message box 1text_onetext
Text for the template's message box 1 (the one with a pink border in Thankster's editor), up to 400 characters. Left empty, the template's own text stays.
Message box 2text_twotext
Text for the template's message box 2 (the one with a orange border in Thankster's editor), up to 400 characters. Left empty, the template's own text stays.
Message box 3text_threetext
Text for the template's message box 3 (the one with a blue border in Thankster's editor), up to 400 characters. Left empty, the template's own text stays.
Message box 4text_fourtext
Text for the template's message box 4 (the one with a purple border in Thankster's editor), up to 400 characters. Left empty, the template's own text stays.

Outputs

boxes_setlist
The boxes that were filled in, such as text_one
messagetext
Thankster's own words about it
recipient_idtext
The recipient whose card was changed
Example output
{
  "boxes_set": [
    "text_one",
    "text_two"
  ],
  "message": "Message saved",
  "recipient_id": "5877231"
}

On this page