Handwrytten API

Name: Handwrytten API
Brand: Handwrytten API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCommunicationsEmail DeliveryapiKey30 EndpointsREST

For Agents

Send physical handwritten greeting cards through the mail by selecting a card, font, recipient address, and optional gift card via REST.

Install Jentic One Beta

Connect the Handwrytten API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Handwrytten API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Handwrytten API.

Browse the Handwrytten card catalogue and pull a specific card's full details

Upload a custom card design or logo for reuse across orders

List available handwriting fonts including those compatible with the customizer

GET STARTED

Start building with Handwrytten API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Handwrytten API for, with concrete tasks.

★ Customer Win-Back Cards

Trigger a handwritten thank-you or win-back card whenever a high-value customer hits a milestone in a CRM. The Handwrytten API places a single-step order via /orders/singleStepOrder with the card, font, message, and recipient address, and returns an order confirmation. Cards typically print and ship within 1-2 business days from the API call.

When a Salesforce opportunity closes-won above $10k, call POST /orders/singleStepOrder with a thank-you card, the rep's font, and the customer's mailing address.

Branded Card Templates

Upload a company logo or custom card front via /cards/uploadCustomLogo and /cards/createCustomCard so future orders use a branded design without re-uploading. The API stores the custom card and returns a card ID that can be referenced like any catalogue card. Useful for marketing teams that want a consistent look across all handwritten outreach.

Upload a PNG logo via POST /cards/uploadCustomLogo and then POST /cards/createCustomCard to register the branded design as card template 'company-thanks-2026'.

Gift Card with Greeting

Bundle a handwritten card with an attached gift card for referral rewards or employee recognition. Use /giftCards/view to confirm available denominations, then place the order through /orders/singleStepOrder with the gift card payload included. Handwrytten handles printing, gift card attachment, and physical delivery in a single API call.

Send a handwritten congratulations card with a $25 gift card to a new hire's home address using POST /orders/singleStepOrder.

AI Agent Mail Automation

Let an AI agent send physical thank-you cards on behalf of a sales rep when a deal closes. Through Jentic the agent searches for 'send a handwritten card', loads the /orders/singleStepOrder schema, and executes with the recipient and message. The session UID is rotated by Jentic so the agent never holds long-lived credentials.

When asked 'send Amy a thank-you card for the demo', call POST /orders/singleStepOrder with cardId, font, message, and Amy's address from the recipient list.

Key Endpoints

30 endpoints — handwrytten is a service that prints and mails physical greeting cards written by robots in a chosen handwriting style.

METHOD

PATH

DESCRIPTION

POST

/auth/authorization

POST

/orders/singleStepOrder

Place a card order in a single call

GET

/cards/list

List available cards

POST

/cards/createCustomCard

Create a custom card design

POST

/cards/uploadCustomLogo

Upload a logo or cover image

GET

/fonts/list

List available handwriting fonts

POST

/profile/profileAddRecipient

Add a recipient address

POST

/profile/recipientsList

List recipients in the user's account

POST

/auth/authorization

POST

/orders/singleStepOrder

Place a card order in a single call

GET

/cards/list

List available cards

POST

/cards/createCustomCard

Create a custom card design

POST

/cards/uploadCustomLogo

Upload a logo or cover image

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Handwrytten account email and password are stored in the Jentic vault. Jentic exchanges them at POST /auth/authorization, holds the resulting session UID for the call, and discards it after, so raw credentials never enter the agent's prompt context.

Intent-based discovery

Agents search Jentic for 'send a handwritten thank you card' and Jentic returns POST /orders/singleStepOrder with the schema, removing the need to read Handwrytten's SwaggerHub docs.

Time to first call

Direct integration: 1-2 days to model auth, custom card upload, and order placement. Through Jentic: under 30 minutes.

FAQs

Specific to using Handwrytten API through Jentic.

What authentication does the Handwrytten API use?

Handwrytten uses session-based auth. Call POST /auth/authorization with email and password to receive a session UID, then include the UID with subsequent requests; POST /auth/logout invalidates the session. Through Jentic the credentials live in the encrypted vault and the session UID is rotated automatically.

Can I send a handwritten card in a single API call with Handwrytten?

Yes. POST /orders/singleStepOrder accepts the cardId, font, message, recipient address, and optional gift card in one request and returns an order confirmation. This avoids chaining the cart, address, and checkout endpoints separately.

What are the rate limits for the Handwrytten API?

Handwrytten does not publish a documented per-second rate limit. Their support team recommends contacting contact@handwrytten.com for sandbox accounts or to request bulk send throughput. Build clients to back off on HTTP 429 if encountered.

How do I send a thank-you card through Jentic?

Search Jentic for 'send a handwritten thank you card', load the schema for POST /orders/singleStepOrder, and execute with cardId, font, message, and recipient. Run pip install jentic and use the async client.search, client.load, and client.execute pattern.

Does Handwrytten support email or SMS delivery?

No. Handwrytten prints physical cards with a robotic handwriting machine and mails them via standard postal services. There is no email or SMS channel. For digital delivery, pair Handwrytten with a separate email or SMS API.

Can I attach a gift card to a Handwrytten order?

Yes. Call /giftCards/view to confirm available denominations and brands, then include the gift card payload in the POST /orders/singleStepOrder request body. The gift card is enclosed inside the printed card and mailed together.

Handwrytten API

Connect the Handwrytten API to your agent

Capabilities

Start building with Handwrytten API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs