# thanks.io Direct Mail Automation Toolkit

## Docs

- [API Testing Mode](https://docs.thanks.io/api-reference/api-mode.md)
- [API Log](https://docs.thanks.io/api-reference/audit-log.md): Description of your new file.
- [List Gift Card Brands](https://docs.thanks.io/api-reference/endpoint/giftcards/list-brands.md): List all available Giftcard brands.
- [List Gift Card Brands Flat](https://docs.thanks.io/api-reference/endpoint/giftcards/list-brands-flat.md): List all available Giftcard brands as a flat list.
- [List Handwriting Styles](https://docs.thanks.io/api-reference/endpoint/handwriting-styles/list-styles.md): List Available Handwriting Styles
- [List Image Templates](https://docs.thanks.io/api-reference/endpoint/image-templates/list-all-image-templates.md): List all available image templates.
- [Create Mailing List](https://docs.thanks.io/api-reference/endpoint/mailing-lists/create-mailing-list.md): If qrcode_url is provided, it will be used as the default QR Code URL when placing orders with this mailing list.
- [Delete Mailing List](https://docs.thanks.io/api-reference/endpoint/mailing-lists/delete-mailing-list.md)
- [Get Details](https://docs.thanks.io/api-reference/endpoint/mailing-lists/get-details.md): Gets a mailing list by ID. Returns a single mailing list object.
- [List All](https://docs.thanks.io/api-reference/endpoint/mailing-lists/list-all.md): List all available mailing lists. Returns a paginated list of mailing lists.
- [List Recipients](https://docs.thanks.io/api-reference/endpoint/mailing-lists/list-recipients.md): Retrieve recipients for a specific mailing list.
- [Radius Search](https://docs.thanks.io/api-reference/endpoint/mailing-lists/radius-search.md): This call will purchase a radius search mailing listing and add it to your account. Each record added to the mailing list costs $.05. You can specify the number of records to return (up to 10,000) and the address/postal code to center the search around. You can also specify a mailing_list_id to add…
- [List Message Templates](https://docs.thanks.io/api-reference/endpoint/message-templates/list-all-message-templates.md): List all available message templates.
- [Cancel Order](https://docs.thanks.io/api-reference/endpoint/orders/cancel-order.md): If Order is in _Reviewing_ Status, then this will cancel the order and refund the credits for the order back to your account.  If the order can be successfully canceled, the status will be updated to _cancelled_.
- [List Orders](https://docs.thanks.io/api-reference/endpoint/orders/list-orders.md): Return list of recent orders.
- [Track Order](https://docs.thanks.io/api-reference/endpoint/orders/track-order.md): Return Summary of delivery status for the order.
- [Create Multiple Recipients](https://docs.thanks.io/api-reference/endpoint/recipients/create-multiple-recipients.md): Add multiple recipients at once using a JSON array of recipient objects. If no/invalid address is specified and a valid email address is, we’ll attempt to look up a valid street address using the email address for a fee.
- [Create Recipient](https://docs.thanks.io/api-reference/endpoint/recipients/create-recipient.md): Add a recipient. If no/invalid address is specified and a valid email address is, we’ll attempt to look up a valid street address using the email address for a fee.
- [Delete Recipient](https://docs.thanks.io/api-reference/endpoint/recipients/delete-recipient.md)
- [Delete Recipient By Address](https://docs.thanks.io/api-reference/endpoint/recipients/delete-recipient-by-address.md): Delete a recipient by using their address or their email address.
- [Recipient Details](https://docs.thanks.io/api-reference/endpoint/recipients/get-details.md): Gets a recipient by ID. Returns a single recipient object.
- [Update Recipient](https://docs.thanks.io/api-reference/endpoint/recipients/update-recipient.md): Update details of a specific recipient by ID.
- [Send Giftcard](https://docs.thanks.io/api-reference/endpoint/send-mailer/send-giftcard.md): Send a folded 4.25x5.5 giftcard in envelope.
- [Send Magnacard](https://docs.thanks.io/api-reference/endpoint/send-mailer/send-magnacard.md): Send a Magnacard.
- [Send Notecard](https://docs.thanks.io/api-reference/endpoint/send-mailer/send-notecard.md): Send a folded 4.25x5.5 notecard in envelope.
- [Send Postcard](https://docs.thanks.io/api-reference/endpoint/send-mailer/send-postcard.md): Send a 4x6, 6x9, or 6x11 postcard.
- [Send Windowed Letter](https://docs.thanks.io/api-reference/endpoint/send-mailer/send-windowed-letter.md): Send a letter in a windowed envelope.
- [Send Windowless Letter](https://docs.thanks.io/api-reference/endpoint/send-mailer/send-windowless-letter.md): Send a letter in a windowless envelope.
- [Create Sub-Account](https://docs.thanks.io/api-reference/endpoint/sub-accounts/create-sub-account.md): Create a new sub-account.
- [Delete Sub-Account](https://docs.thanks.io/api-reference/endpoint/sub-accounts/delete-sub-account.md): Delete a sub-account. All sub-account orders and mailing lists are moved to the main account. All image templates, message templates, and campaigns are deleted.
- [Show Sub-Account](https://docs.thanks.io/api-reference/endpoint/sub-accounts/get-details.md): Gets a sub-account by ID. Returns a single sub-account object.  branding_fields is an object that contains branding information for the sub-account - it can only be set via the thanks.io dashboard
- [List Sub-Accounts](https://docs.thanks.io/api-reference/endpoint/sub-accounts/list-all.md): List all available sub-accounts.
- [Update Sub-Account](https://docs.thanks.io/api-reference/endpoint/sub-accounts/update-sub-account.md)
- [Create Webhook](https://docs.thanks.io/api-reference/endpoint/webhooks/create-webhook.md): Create a webhook destination. Webhooks are available on paid subscriptions only.
- [Delete Webhook](https://docs.thanks.io/api-reference/endpoint/webhooks/delete-webhook.md): Delete a webhook destination. Webhooks are available on paid subscriptions only.
- [List Webhooks](https://docs.thanks.io/api-reference/endpoint/webhooks/list-all.md): Return a paginated list of configured webhooks. Webhooks are available on paid subscriptions only.
- [Update Webhook](https://docs.thanks.io/api-reference/endpoint/webhooks/update-webhook.md): Update an existing webhook destination. Webhooks are available on paid subscriptions only.
- [REST API Overview](https://docs.thanks.io/api-reference/introduction.md): Learn about thanks.io's REST API capabilities
- [Usage](https://docs.thanks.io/api-reference/mailing-lists-usage.md): Info on using thanks.io's Mailing Lists endpoints
- [OpenAPI Specification](https://docs.thanks.io/api-reference/openapi-link.md): The complete OpenAPI specification for the thanks.io API can be found [here](https://raw.githubusercontent.com/thanks-io/thanks.io-api-docs/refs/heads/main/api-reference/openapi.json).
- [Rate Limits](https://docs.thanks.io/api-reference/rate-limits.md): Understand the rate limits for the thanks.io API.
- [Usage](https://docs.thanks.io/api-reference/recipients-usage.md): Info on using thanks.io's Recipients endpoints
- [Usage](https://docs.thanks.io/api-reference/send-mailer-usage.md): Info on using thanks.io's Send Mailer endpoints
- [Bearer Token](https://docs.thanks.io/authentication/bearer-token.md): API Authentication
- [OAuth](https://docs.thanks.io/authentication/oauth.md): OAuth Authentication integrating thanks.io with your application
- [Overview](https://docs.thanks.io/creatives/inspirations/notecards.md)
- [Birthday Notecards](https://docs.thanks.io/creatives/inspirations/notecards-birthday.md): Birthday-themed notecard inspirations and templates
- [Co-Worker Notecards](https://docs.thanks.io/creatives/inspirations/notecards-work.md): Co-Worker greeting card inspirations and templates
- [Overview](https://docs.thanks.io/creatives/inspirations/postcards.md)
- [4th of July Postcards](https://docs.thanks.io/creatives/inspirations/postcards-4thofjuly.md): Fourth of July and Independence Day-themed postcard inspirations and templates
- [Anniversary Postcards](https://docs.thanks.io/creatives/inspirations/postcards-anniversary.md): Anniversary-themed postcard inspirations and templates
- [April Fools Postcards](https://docs.thanks.io/creatives/inspirations/postcards-aprilfools.md): April Fools-themed postcard inspirations and templates
- [Birthday Postcards](https://docs.thanks.io/creatives/inspirations/postcards-birthday.md): Birthday-themed postcard inspirations and templates
- [Campaigns Postcards](https://docs.thanks.io/creatives/inspirations/postcards-campaigns.md): Campaigns-themed postcard inspirations and templates
- [Car Dealership Postcards](https://docs.thanks.io/creatives/inspirations/postcards-cardealership.md): Car Dealership-themed postcard inspirations and templates
- [Chiropractor Postcards](https://docs.thanks.io/creatives/inspirations/postcards-chiropractor.md): Chiropractor-themed postcard inspirations and templates
- [Christmas Postcards](https://docs.thanks.io/creatives/inspirations/postcards-christmas.md): Christmas-themed postcard inspirations and templates
- [Church Postcards](https://docs.thanks.io/creatives/inspirations/postcards-church.md): Church-themed postcard inspirations and templates
- [Contractors Postcards](https://docs.thanks.io/creatives/inspirations/postcards-contractors.md): Contractors-themed postcard inspirations and templates
- [Dentist Postcards](https://docs.thanks.io/creatives/inspirations/postcards-dentist.md): Dentist-themed postcard inspirations and templates
- [Earth Day Postcards](https://docs.thanks.io/creatives/inspirations/postcards-earthday.md): Earth Day-themed postcard inspirations and templates
- [Easter Postcards](https://docs.thanks.io/creatives/inspirations/postcards-easter.md): Easter-themed postcard inspirations and templates
- [E-commerce Postcards](https://docs.thanks.io/creatives/inspirations/postcards-ecommerce.md): E-commerce-themed postcard inspirations and templates
- [Father's Day Postcards](https://docs.thanks.io/creatives/inspirations/postcards-fathersday.md): Fathers day-themed postcard inspirations and templates
- [Funny Postcards](https://docs.thanks.io/creatives/inspirations/postcards-funny.md): Funny-themed postcard inspirations and templates
- [Halloween Postcards](https://docs.thanks.io/creatives/inspirations/postcards-halloween.md): Halloween-themed postcard inspirations and templates
- [Hanukkah Postcards](https://docs.thanks.io/creatives/inspirations/postcards-hanukkah.md): Hanukkah-themed postcard inspirations and templates
- [Holiday Postcards](https://docs.thanks.io/creatives/inspirations/postcards-holiday.md): Holiday-themed postcard inspirations and templates
- [HouseAnniversary Postcards](https://docs.thanks.io/creatives/inspirations/postcards-houseaversary.md): Anniversary-themed postcard inspirations and templates
- [Labor Day Postcards](https://docs.thanks.io/creatives/inspirations/postcards-laborday.md): Labor Day-themed postcard inspirations and templates
- [Lawyer Postcards](https://docs.thanks.io/creatives/inspirations/postcards-lawyer.md): Lawyer-themed postcard inspirations and templates
- [Memorial day Postcards](https://docs.thanks.io/creatives/inspirations/postcards-memorialday.md): Memorial day-themed postcard inspirations and templates
- [Mother's Day Postcards](https://docs.thanks.io/creatives/inspirations/postcards-motherday.md): Mother's Day-themed postcard inspirations and templates
- [New Year Postcards](https://docs.thanks.io/creatives/inspirations/postcards-newyear.md): New year-themed postcard inspirations and templates
- [Politics Postcards](https://docs.thanks.io/creatives/inspirations/postcards-politics.md): Politics-themed postcard inspirations and templates
- [Real Estate Postcards](https://docs.thanks.io/creatives/inspirations/postcards-realestate.md): Real Estate-themed postcard inspirations and templates
- [St. Patrick's Day Postcards](https://docs.thanks.io/creatives/inspirations/postcards-stpatricks.md): St. Patrick's Day-themed postcard inspirations and templates
- [Thanksgiving Postcards](https://docs.thanks.io/creatives/inspirations/postcards-thanksgiving.md): Thanksgiving-themed postcard inspirations and templates
- [Thank You Postcards](https://docs.thanks.io/creatives/inspirations/postcards-thankyou.md): Thank You-themed postcard inspirations and templates
- [Valentine's Day Postcards](https://docs.thanks.io/creatives/inspirations/postcards-valentinesday.md): Valentine's Day-themed postcard inspirations and templates
- [Veterans Postcards](https://docs.thanks.io/creatives/inspirations/postcards-veterans.md): Veterans-themed postcard inspirations and templates
- [Veterinarian Postcards](https://docs.thanks.io/creatives/inspirations/postcards-veterinarian.md): Veterinarian-themed postcard inspirations and templates
- [Window Cleaning Postcards](https://docs.thanks.io/creatives/inspirations/postcards-windowcleaning.md): Window Cleaning-themed postcard inspirations and templates
- [Creatives Overview](https://docs.thanks.io/creatives/introduction.md)
- [4x6 Postcards](https://docs.thanks.io/creatives/templates/4x6postcards.md): Starting templates to help you design your mailers
- [6x11 Postcards](https://docs.thanks.io/creatives/templates/6x11postcards.md): Starting templates to help you design your mailers
- [6x9 Postcards](https://docs.thanks.io/creatives/templates/6x9postcards.md): Starting templates to help you design your mailers
- [Magnacards](https://docs.thanks.io/creatives/templates/magnacards.md): Starting templates to help you design your mailers
- [Notecards](https://docs.thanks.io/creatives/templates/notecards.md): Starting templates to help you design your mailers
- [Windowed Letters](https://docs.thanks.io/creatives/templates/windowed-letters.md): Starting templates to help you design your mailers
- [Windowless Letters](https://docs.thanks.io/creatives/templates/windowless-letters.md): Starting templates to help you design your mailers
- [Creative Images](https://docs.thanks.io/faqs/images.md): How do I set the creative image for an Order?
- [Creative Message](https://docs.thanks.io/faqs/messages.md): How do I set the creative message for an Order?
- [Order Preview](https://docs.thanks.io/faqs/previews.md): How do I preview an order?
- [QR Codes](https://docs.thanks.io/faqs/qrcode.md): How do I set the trackable QR code for an Order?
- [Quick Implementation](https://docs.thanks.io/faqs/quick-implementation.md): What's the easiest way to integrate with thanks.io?
- [Return Address](https://docs.thanks.io/faqs/return-address.md): How is return address set for an order?
- [Welcome](https://docs.thanks.io/index.md): Welcome to thanks.io
- [MCP Server](https://docs.thanks.io/mcp-server.md): Model Context Provider (MCP) server to add thanks.io direct mail capabilities to your application.
- [API Nation](https://docs.thanks.io/native-integrations/available/api-nation.md): thanks.io / API Nation Integration
- [API Nation Webhooks](https://docs.thanks.io/native-integrations/available/api-nation-webhooks.md): thanks.io / API Nation Webhooks Integration
- [Bold Trail/kvCORE](https://docs.thanks.io/native-integrations/available/boldtrail.md): thanks.io / Bold Trail Integration
- [Email](https://docs.thanks.io/native-integrations/available/email.md): thanks.io Email Integration
- [Embed Widget](https://docs.thanks.io/native-integrations/available/embed-widget.md): thanks.io Embed Widget Integration
- [HighLevel](https://docs.thanks.io/native-integrations/available/highlevel.md): thanks.io / HighLevel Integration
- [HubSpot](https://docs.thanks.io/native-integrations/available/hubspot.md): thanks.io / HubSpot Integration
- [Integrately](https://docs.thanks.io/native-integrations/available/integrately.md): thanks.io / Integrately Integration
- [make](https://docs.thanks.io/native-integrations/available/make.md): thanks.io / make Integration
- [MedicarePRO](https://docs.thanks.io/native-integrations/available/medicarepro.md): thanks.io / MedicarePRO Integration
- [n8n Integration](https://docs.thanks.io/native-integrations/available/n8n.md): Automate thanks.io directly from your n8n workflows
- [Pabbly](https://docs.thanks.io/native-integrations/available/pabbly.md): thanks.io / Pabbly Integration
- [Sure Send](https://docs.thanks.io/native-integrations/available/sure-send.md): thanks.io / Sure Send Integration
- [viaSocket](https://docs.thanks.io/native-integrations/available/viasocket.md): thanks.io / viaSocket Integration
- [Zapier](https://docs.thanks.io/native-integrations/available/zapier.md): thanks.io / Zapier Integration
- [Zoho](https://docs.thanks.io/native-integrations/available/zoho.md): thanks.io / Zoho Integration
- [Native Integrations](https://docs.thanks.io/native-integrations/introduction.md): Native Integrations to easily connect thanks.io with your favorite tools
- [Quickstart](https://docs.thanks.io/quickstart.md): Start sending awesome mailers in under 5 minutes
- [Product Updates](https://docs.thanks.io/updates.md): New Features, Updates and Announcements
- [Order Item Delivered](https://docs.thanks.io/webhooks/available/order-item-delivered.md): Event will fire whenever an Recipient's Order Item (Mail Piece) is delivered
- [Order Item Status Change](https://docs.thanks.io/webhooks/available/order-item-status-change.md): Event will fire whenever an Recipient's Order Item (Mail Piece) changes status. An order item represents the details of an individual mail piece sent to a recipient.
- [Order Status Change](https://docs.thanks.io/webhooks/available/order-status-change.md): Event will fire whenever an Order changes status.
- [QR Code Scans](https://docs.thanks.io/webhooks/available/qr-code-scans.md): Event will fire whenever a recipient scans a thanks.io QR Code on your mailer.
- [Webhooks](https://docs.thanks.io/webhooks/introduction.md): Real time event notifications with thanks.io webhooks
- [Add Recipient to Campaign](https://docs.thanks.io/workflows/campaign.md): Add a recipient to an existing campaign via API
- [Giftcard Order](https://docs.thanks.io/workflows/giftcard-order.md): Giftcards can be sent to recipients via the API.
- [PDF Letter Order](https://docs.thanks.io/workflows/letter-pdf-order.md): Submit an order using just a PDF via API
- [Postcard Order](https://docs.thanks.io/workflows/postcard-order.md): Postcard Orders can be placed directly via the API

## OpenAPI Specs

- [openapi](https://docs.thanks.io/api-reference/openapi.json)