Direct mail API: send personalized postcards and letters from your own software

The Yotru API lets your CRM, store or booking system send printed, personalized postcards and letters by itself, in 16 countries and 10 languages. You make a card or a letter, add recipients and approve. You do not need a design file: Yotru builds it from your website. Every piece carries the recipient's name and its own QR code, so you see exactly who responded.

What you get

No design work
Send a website address and Yotru builds the card or letter with your logo and colors. Or pick a template and send your own text and photo.
Personal for every recipient
Each piece has the recipient's name, its own QR code and its own landing page. Custom fields per recipient are optional.
See who responded
Every scan belongs to one recipient. You see it in your dashboard and can get a notification by email or Slack the moment it happens.
Free to build and test
Making cards and letters, fetching previews and adding recipients costs nothing. You pay when you approve a campaign.
16 countries, 10 languages
Postcards go to Canada, the United States, the Netherlands, Germany, Spain and the United Kingdom. Letters go there and to 10 more European countries, written in the reader's language.
Printing and postage included
One price per piece covers design, print and delivery. A person on our side checks every batch before it prints.

How it works

StepCallWhat happens
1POST /v1/cardsMake a card or a letter, with product, country and language. Anything you leave out comes from the template or is read from your website.
2POST /v1/recipientsAdd up to 1,000 recipients per call. The first call opens a campaign by itself.
3POST /v1/campaigns/{id}/approveApprove. The answer contains a payment link, and the campaign goes to print once it is paid.
curl -X POST https://api.yotru.com/v1/cards \
  -H "Authorization: Bearer $YOTRU_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Spring offer","product":"card","country":"CA","website":"https://example.com"}'

curl -X POST https://api.yotru.com/v1/recipients \
  -H "Authorization: Bearer $YOTRU_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cardId":"CARD_ID","recipients":[{"name":"Anna Smith","addressLine1":"100 Main Street","postcode":"M5V 2T6","city":"Toronto","region":"ON","country":"CA"}]}'

A preview call returns the card or letter exactly as it will be printed, so you can check it before you approve.

What you can build with it

  • Win-back mail. Your store sends a card to customers who have not ordered in six months.
  • Anniversary and renewal mail. Your CRM sends a letter when someone has been a customer for a year.
  • Follow-ups. Your booking system sends a card after a first visit or a missed appointment.
  • Mail for your own customers. Your software offers postcards and letters to its users, with you as the sender of record.

What it costs

The same per-piece price as an order placed on the site, with printing and postage included. A postcard in Canada costs $2.69 at 100 and $1.60 at 5,000. There is no minimum: below 100 pieces each one costs a little more, never more in total than 100. Making cards and letters and adding recipients is free.

See the prices

Good to know before you build

  • Cards are built from ten templates and letters from four, filled with your own text, colors, logo and photo. Uploading a finished design of your own is not part of the API yet.
  • One card or letter posts to one country, and its recipients live there. For a second country, make a second card or letter.
  • A campaign's status is one call away: open, awaiting payment, approved, printing or sent. Up to 1,000 recipients go in one call, and a repeated call is safe with an Idempotency-Key header.

Questions about the API

Is there a test mode or sandbox?
No, and you do not need one. Making cards and letters, fetching previews and adding recipients costs nothing and mails nothing. Only approving a campaign costs money.
How do I get an API key?
Make an account and open Settings, then Integrations and API keys. Your first key is made when you open that page and is shown once. You have to be an owner or admin with a confirmed email address.
Where does Yotru print and mail?
Postcards go to Canada, the United States, the Netherlands, Germany, Spain and the United Kingdom. Letters go there too, and to France, Belgium, Luxembourg, Austria, Switzerland, Sweden, Norway, Denmark, Finland and Iceland. Set product and country on the card.
Which languages can a card or letter be in?
English, Dutch, French, German, Spanish, Swedish, Norwegian, Danish, Finnish, Icelandic, Italian, Portuguese, Polish, Czech, Slovak, Hungarian, Romanian, Bulgarian, Croatian, Slovenian, Greek, Estonian, Latvian and Lithuanian. Without a language, it is written in the language of the country it goes to.
What happens to a wrong address?
That recipient is refused with a reason, such as address or duplicate, and the rest of the list goes through.
Are there rate limits?
Each key can make 120 calls a minute, and 300 calls a day that make or change cards or send photos.
Can I see who responded to a postcard or letter?
Yes. Each piece has its own QR code, so every scan belongs to one recipient. You see it in your dashboard and can be notified right away.
Does it work with my CRM or store?
Any system that can make an HTTPS call can use the API. HubSpot users can also connect their lists directly in the dashboard, without code.

Why we built it this way: How we built the Yotru postcard API.