Send postcards and letters from your own software.
Create personalized physical mail through the MailerBot REST API. Manage recipients, prepare mailings, and follow their status while MailerBot handles printing and mailing.
Check your API key
curl https://api.mailerbot.com/api/v1/auth/me -H "X-API-Key: mb_test_REPLACE_WITH_YOUR_KEY"
How it works
Add recipients and a design
Create contacts and lists, and the postcard or letter design you want to mail.
Create a draft mailing
Combine a list and a design into a mailing. Nothing is sent yet.
Review the cost
A mailing's cost estimate excludes postage. The cart total includes all applicable charges.
Send and follow status
Send with an explicit API request, then follow each mailing's status through the API or webhooks.
FAQ
Your own server sends an API key in the X-API-Key header. Apps that act for other MailerBot users use OAuth 2.1 with PKCE.
Yes. Mailings created with a test key are never charged, printed or mailed. Everything else a test key creates or changes is real data in your account. OAuth access is always live.
No. The estimate excludes postage. Check the cart total, which includes all applicable charges, before you send.
Read it through the API or receive status events with webhooks. For test mailings, you can advance the status one step at a time.