Direct mail API: send personalized postcards from your own software
The Yotru postcard API lets your CRM, store or booking system send printed, personalized postcards by itself. You make a card, add recipients and approve. You do not need a design file: Yotru builds the card from your website. Every card 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 with your logo and colors. Or pick a template and send your own text and photo.
- Personal for every recipient
- Each card 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, fetching previews and adding recipients costs nothing. You pay when you approve a campaign.
- Checked before it prints
- After you approve, a person on our side looks at the batch before it goes to the printer.
- Printing and postage included
- One price per card covers design, print and delivery.
How it works
| Step | Call | What happens |
|---|---|---|
| 1 | POST /v1/cards | Make a card. Anything you leave out comes from the template or is read from your website. |
| 2 | POST /v1/recipients | Add up to 1,000 recipients per call. The first call opens a campaign by itself. |
| 3 | POST /v1/campaigns/{id}/approve | Approve. The answer contains a payment link, and the campaign goes to print once it is paid. |
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 de Vries","street":"Kerkstraat","houseNumber":"12","postcode":"1011 AB","city":"Amsterdam","country":"NL"}]}'A preview call returns the card exactly as it will be printed, so you can check it before you approve.
What you can build with it
- Win-back cards. Your store sends a card to customers who have not ordered in six months.
- Anniversary and renewal cards. Your CRM sends a card 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 to its users, with you as the sender of record.
What it costs
The same per-card price as an order placed on the site, with printing and postage included. There is no minimum: below 100 cards, each one costs the per-card price for 100. Making cards and adding recipients is free.
Good to know before you build
- Cards are built from ten templates that you fill with your own text, colors, logo and photo. Uploading a finished design of your own is not part of the API yet.
- 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, 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 API. 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.
- 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.
- Do I need a designer or a design file?
- No. Send your website address and Yotru builds the card with your logo and colors. You can also set the text, colors, logo and photo yourself.
- Can I see who responded to a postcard?
- Yes. Each card 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.
- Where does Yotru print and mail?
- The country field on a card takes NL, CA or US.
Why we built it this way: How we built the Yotru postcard API.