Skip to main content
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. Create one in your dashboard under Settings → API Access: in the API Keys section, click Create API Key, name the key, and copy it. The key is shown only once.

​
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:

​
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:
For production sends, we recommend sending a saved creative with creative_id in place of the image and message parameters. See Send a Creative. For a full first-request walkthrough, including testing mode, see the Quickstart.