Use bearer token authentication when your integration sends requests from a single thanks.io account that you control. This is the simplest authentication method and the best starting point for most direct API integrations. If you are building a multi-account SaaS integration where each customer connects their own thanks.io account, use OAuth instead.

API Key

All API requests must be authenticated with a bearer token. This token can be created in your API Settings under the “Personal Access Tokens (API Key)” section.

Bearer Token

Once you have created a token, you can use it to authenticate your API requests by including it in the Authorization header as follows:

Authorization: Bearer YOUR_ACCESS_TOKEN

Best For

Internal tools and back-office automation
Server-to-server integrations
Your first API prototype or production integration for a single thanks.io account

Example Request

Here is a minimal example of an authenticated request using curl:

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"
  }'

For a full first-request walkthrough, including testing mode, see the Quickstart.

Get Started

Authentication

API Endpoints

Examples

Bearer Token

API Key

Bearer Token

Best For

Example Request

​API Key

​Bearer Token

​Best For

​Example Request

API Key

Bearer Token

Best For

Example Request