Handwrytten API
About
Send personalized, handwritten cards to anyone using the Handwrytten API. Choose from a variety of handwriting styles, customize cards with your logo, and automate your card-sending workflow at any scale.
Test Mode
During development your account can be switched to test mode on the Integrations page in your dashboard. In test mode, orders are accepted normally but are not fulfilled. Payments are authorized but not captured, so any pending charge will drop off without posting. Just make sure to switch back to live mode before going live.
Client Libraries
If you're working in Python or JavaScript/TypeScript, you can use one of the official client packages instead of making raw API calls:
- Python:
handwryttenon PyPI - JavaScript/TypeScript:
handwryttenon npm Documentation for each package is available on the respective package page.
Authentication
Authenticate by including your API key in the Authorization request header — pass the key directly, with no Bearer: prefix:
Authorization: YOUR_API_KEY
API keys can be created and managed on the Integrations page in your dashboard.
Note: Authentication using login/password via
/auth/authorizationis deprecated. It remains supported for existing integrations but is not recommended for new ones.