Developer API

Handwritten Mail API

Send real pen-written cards and letters from your own software. Make one API call and Simply Noted robots write your message with a real ballpoint pen, then address, stamp and mail it for you.

View full API docsGet an API key

To get an API key, create a Simply Noted account.

How it works

The Simply Noted API is a REST API at https://live.simplynoted.com/api/v2. Every request sends two headers: x-api-key and x-user-id.

Main resources

  • cardsThe card artwork set up in your account.
  • single_card_mailingsSend a one-off card to one recipient in a single request.
  • mailingsSend to any number of recipients, then check status and tracking.
  • listsRecipient lists, including custom merge variables.
  • messagesReusable message templates.
  • handwriting_stylesThe handwriting styles you can use.

Send a single card

This is the "Send single card mailing" request from the API docs. Replace the placeholder key, user ID, card ID, sender profile ID and contact with your own. Find your sender profile ID with GET /api/v2/sender_profiles. Send either message_body or a message_id template.

curl -X POST https://live.simplynoted.com/api/v2/single_card_mailings \
  -H "x-api-key: 1234" \
  -H "x-user-id: 1234" \
  -H "Content-Type: application/json" \
  -d '{
    "single_card_mailing": {
      "card_id": "1224",
      "sender_profile_id": "YOUR_SENDER_PROFILE_ID",
      "message_body": "Hi This is a test ",
      "name": "Do Not Mail - ",
      "contact": {
        "first_name": "John",
        "last_name": "Smith",
        "street_1": "26922 Lake Rd",
        "city": "Bay Village",
        "state": "OH",
        "zipcode": "44140"
      }
    }
  }'

What teams build with the API

CRM-triggered thank-yous

Send a handwritten thank-you when a deal closes or a contact changes stage in your CRM.

Post-purchase cards (Shopify)

Mail a handwritten card to customers after they order.

Real estate

Send real pen notes to past clients and new prospects.

Financial services

Follow up with clients and prospects with a personal note.

B2B sales follow-up

Send a handwritten note after a meeting, demo or signed contract.

Batch sends from lists

Upload a list with merge variables and mail every recipient at once.

Pricing

  • Unlimited plan: $497 per month flat, then $0.99 per note card or $0.84 per postcard, plus postage. Includes every integration, including the API.
  • Pay as you go: credit packages from $2.80 per note card (100 credits) down to $0.90 (50,000 credits), plus postage. The more you buy, the lower the per-card price.
See all plans and pricing

Start sending handwritten mail from your code

View full API docsGet an API key

Last updated · By the Simply Noted team