Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.thanks.io/llms.txt

Use this file to discover all available pages before exploring further.

Use this quickstart if you want to send mailers directly from your application. If you want your users to manage campaigns and automation inside thanks.io, start with the campaign workflow instead.

​
Before You Start

You will need:

​
Choose the Right Path

There are two common ways to integrate with thanks.io:
  • Automation workflow: add recipients to a mailing list and let thanks.io handle campaign logic. This is usually the best fit for recurring sends and user-managed campaigns.
  • Direct API sends: create orders from your application and send mail immediately. This quickstart covers that path.
Once you know you want direct sends, follow the steps below to submit your first order.
1

Create Account

Create an account at thanks.io if you have not already.
2

Create An API Key

Visit API Settings and create a personal access token for your integration.
3

Enable Testing Mode

Turn on API/Zapier Test Mode to avoid sending real mail while testing. In testing mode, API orders are automatically canceled instead of mailed. See API Testing Mode for details.
4

Submit Your First Order

This example sends a postcard directly through the API using an inline recipient, message, and front image URL.
curl -X POST "https://api.thanks.io/api/v2/send/postcard" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "recipients": [{ 
      "name": "John Doe", 
      "address": "123 Main Street, Any Town, NY 12345"
    }],
    "message": "Hi %FIRST_NAME% - Thank you for your business!",
    "front_image_url": "https://d2md0c8rpvzmz5.cloudfront.net/inspiration_templates/default10.png"
  }'
5

Check Your Order Status

Check the result in the Order History page. While testing mode is enabled, your order should appear and then be canceled automatically.

​
Next Steps