Send mail anywhere in the world.

Hermes is Hack Club's mail fulfillment API. Send letters, stickers, and packages to hackers worldwide with a simple API call.

Get Started What is Hack Club?

                        const letter = {
                          first_name: "Zach",
                          last_name: "Latta",
                          address_line_1: "15 Falls Rd",
                          city: "Shelburne",
                          state: "VT",
                          postal_code: "05482",
                          country: "United States",
                          rubber_stamps: "1x Pack of Stickers"
                        };
                        
                        await hermes.send(letter);
                        // → Letter queued for delivery! 📬
                    

Everything you need to ship

Powerful features to send mail to hackers anywhere in the world.

📮

Global Delivery

Ship to Canada, the United States, and 200+ countries worldwide with automatic rate calculation.

📦

Pack Anything

We'll pack any items you need—stickers, postcards, socks, PCBs, and more. Send us the goods or use our stock for a small fee.

📦

Multiple Formats

Send lettermail, bubble mailers, or full parcels. Each format optimized for cost and speed.

⚡

Real-time Status

Track every letter from creation to delivery. Get notified when packages ship.

🔐

Event-based API Keys

Each Hack Club event gets its own API key with isolated tracking and billing.

💰

Transparent Pricing

Simple, affordable rates. See the cost before you send with our built-in calculator.

200+

Countries Supported

$1.75

Starting Price (USD)

5-30

Days for Delivery

100%

Open Source

How It Works

Three simple steps to send mail anywhere in the world.

Get Your API Key

DM @jenin on Slack to register your event and get credentials.

Send a Request

POST to /api/v1/letters with recipient info and sticker details.

We Ship It

Your letter gets queued, printed, stamped, and mailed from Canada.

Orders API

The Hermes team will order items from online stores and have them shipped directly to your recipients.

                        const order = {
                          order_text: "GitHub Notebook - 1x black",
                          first_name: "Orpheus",
                          last_name: "Hacksworth",
                          address_line_1: "123 Hacker Way",
                          city: "Shelburne",
                          state: "VT",
                          postal_code: "05482",
                          country: "United States"
                        };
                        
                        await hermes.order(order);
                        // → { status_url: "hack.club/odr-aB3xK9m" }
                    

✓ Order Created

Order ID uFHcDBY

Status Pending

Tracking Link hack.club/odr!uFHcDBY

👆 Click the link to see the tracking page!