Ready-to-run code examples for the Postcard.bot REST API. Send real, printed postcards programmatically.
- Get an API key at postcard.bot/account
- Add balance at postcard.bot/buy-credits
- Pick an example below and run it
| File | Description |
|---|---|
| send-postcard.js | Send a single postcard |
| bulk-send.js | Send postcards to a CSV list of recipients |
| check-status.js | Check postcard delivery status |
| webhooks-server.js | Receive and verify webhook events |
cd node
npm install
POSTCARDBOT_API_KEY=pk_live_your_key node send-postcard.js| File | Description |
|---|---|
| send_postcard.py | Send a single postcard |
| bulk_send.py | Send postcards to a CSV list of recipients |
| check_status.py | Check postcard delivery status |
| webhooks_server.py | Receive and verify webhook events |
cd python
pip install requests flask
POSTCARDBOT_API_KEY=pk_live_your_key python send_postcard.py| File | Description |
|---|---|
| send-postcard.sh | Send a single postcard |
| bulk-send.sh | Send bulk postcards |
| check-balance.sh | Check account balance and pricing tier |
| webhooks.sh | Create, list, and delete webhooks |
cd curl export POSTCARDBOT_API_KEY=pk_live_your_key bash send-postcard.sh
- Developer Docs — full API reference, MCP server setup, pricing
- OpenAPI Spec — import into Postman, Swagger UI, or any API client
- MCP Server — let AI agents send postcards via Claude, Cursor, etc.
Volume pricing based on lifetime top-up amount:
| Tier | Lifetime top-up | USA | International |
|---|---|---|---|
| Pay-as-you-go | 0ドル | 1ドル.99 | 2ドル.99 |
| Starter | 1ドル+ | 1ドル.49 | 2ドル.49 |
| Bronze | 20ドル+ | 1ドル.29 | 2ドル.29 |
| Silver | 50ドル+ | 0ドル.99 | 1ドル.99 |
| Gold | 200ドル+ | 0ドル.85 | 1ドル.85 |
| Platinum | 500ドル+ | 0ドル.79 | 1ドル.79 |
| Diamond | 1,000ドル+ | 0ドル.69 | 1ドル.69 |
All-inclusive: printing + postage + delivery. No subscription.
MIT