---
title: Print and Mail API: Send Letters by REST API | SprintMail
description: A print and mail API for letters: post a PDF and an address, and SprintMail prints and mails it by USPS First-Class, with webhooks and tracking.
url: https://sprintmail.io/print-and-mail-api/
---

# Print and mail API for first-class letters

Send a letter from your app the way you send an email. Post a PDF and an address to the SprintMail API, and we print, seal and mail it by USPS First-Class. Every letter shows up in our tracking portal, for you and for the person you mailed.

[Get API Access](https://sprintmail.io/partnerships/) [Read the API Reference](https://api-production.sprintmail.io/llms.txt)

 

```
POST https://api-staging.sprintmail.io/api/order
x-api-key: YOUR_STAGING_KEY

{
  "externalId": "order-1001",
  "sender": "Acme Corp",
  "letters": [{
    "recipient": "Jane Doe",
    "address": "123 Main St",
    "city": "Austin", "state": "TX", "zipCode": "78701",
    "fileUrl": "https://files.acme.com/invoice-1.pdf",
    "pages": 2
  }]
}
```

```
201 Created

{
  "publicId": "ord_a1b2c3",
  "externalId": "order-1001",
  "status": "CREATED",
  "letters": [{
    "recipient": "Jane Doe",
    "pages": 2,
    "status": "CREATED"
  }],
  "payment_url": "https://checkout.stripe.com/..."
}
```

Staging orders never print. Test the whole flow first.

## From your API call to their mailbox

2.  You post the order
    
    POST /order
    
3.  We print and seal it
    
    El Paso, Texas
    
4.  USPS First-Class
    
    Usually 4 to 7 business days
    
5.  Delivered
    
    Tracked the whole way
    

The Letter updates webhook calls you at every step.

## The endpoints you will use

An order carries as many letters as you need. You pay once for the order, and it prints after payment.

-   POST `/order`
    
    ### Mail a whole batch
    
    One order, as many letters as you need, each with its own recipient and PDF. Send the same externalId twice and it is caught as a duplicate, never a second batch of mail.
    
-   POST `/order/price`
    
    ### Price before you send
    
    The cost from each letter's page count, before anything is created.
    
-   POST `/address/check`
    
    ### Check addresses first
    
    Runs your recipients past USPS before you mail to them.
    
-   POST `/template/{id}/send`
    
    ### Mail a template
    
    Store a letter once and mail it to a new recipient with one call.
    
-   HOOK `Letter updates`
    
    ### Webhooks
    
    A callback as each letter is printed, shipped and delivered.
    

Ready to mail from your software?

[Get API Access](https://sprintmail.io/partnerships/)

## What teams build with it

If you have called it a direct mail API, a letter API, a snail mail API or a print-to-mail API, it is the same call. You send the PDF and the address; SprintMail handles the printing, postage and tracking.

[See the managed service](https://sprintmail.io/print-and-mail-service/)

-   Credit repair disputes
    
    Dispute letters and supporting documents, mailed at volume from your platform.
    
-   Legal and compliance mail
    
    Notices, demand letters and regulated correspondence that has to arrive as paper.
    
-   Invoices and statements
    
    A PDF that needs to reach a mailbox, without a mailroom or a print vendor.
    
-   Customer correspondence
    
    One letter or ten thousand, with tracking your customer can open.
    

## Or let an AI agent do it

The same API powers the SprintMail MCP server. Connect your agent and ask it to mail a letter. Every send starts with a preview you can check.

[See How the MCP Server Works](https://sprintmail.io/mcp/)

-   Claude
-   ChatGPT
-   Cursor
-   Meta Muse

## Why teams mail with SprintMail

-   5,000+
    
    orders every day
    
-   ![USPS](/usps-logo.svg)
    
    First-Class Mail
    
-   Tracking
    
    on every letter
    
-   4.98/5
    
    satisfaction score
    

## Questions

The short answers. Anything else, ask in your application and we will take it from there.

[Ask us directly Add it to your partner application](https://sprintmail.io/partnerships/)

Can I test before I mail for real?

Yes. Approved partners start with a staging key, for the API and the [MCP server](https://sprintmail.io/mcp/). Staging orders never print, and our team can move one to production for you. Then you get a production key. [Apply here](https://sprintmail.io/partnerships/).

How is it priced?

Letters start at $1.75 for the first page.

What can I mail?

Letters from a PDF, in black and white or color, to US addresses.

Is this a direct mail API, a letter API or a snail mail API?

All of those names describe the same thing: you send a PDF and an address to a REST API, and a physical letter is printed and mailed. Some call it a print-to-mail API or a postal mail API; SprintMail calls it a print and mail API.

Do you have a REST API?

Yes. HTTPS and JSON, with an x-api-key header. The full reference is at api-production.sprintmail.io/llms.txt.

What can I build with it?

Credit repair dispute letters, legal notices and demand letters, invoices and statements, collections, compliance mail, and any PDF that needs to arrive as physical mail.

Is there an MCP server for AI agents?

Yes. The same API powers the SprintMail MCP server for Claude, ChatGPT, Cursor, VS Code, Codex and other MCP clients.

Do you offer Certified Mail?

Not yet. Certified Mail might be coming soon. For now, we add features as our users and partners request them.

Keep reading

-   [Print and mail service](https://sprintmail.io/print-and-mail-service/)
-   [Mail letters from your AI agent](https://sprintmail.io/mcp/)
-   [SprintMail vs Lob](https://sprintmail.io/alternatives/lob/)
-   [SprintMail vs PostGrid](https://sprintmail.io/alternatives/postgrid/)

## Mail from your software

API keys go to approved partners. Tell us your monthly volume when you apply, and we will quote by volume.

[Get API Access](https://sprintmail.io/partnerships/)

Mail from your software

[Get API Access](https://sprintmail.io/partnerships/)
