Skip to main content
This guide walks you through signing up, authenticating, and making your first API call.
1

Sign up

Create your TingTing account at app.tingting.io. Once your account is active, you can log in and start using the API.
2

Log in

Send your credentials to the login endpoint. On success, the API sets a JWT access cookie in your browser or HTTP client that you use in subsequent requests.
curl --request POST \
  --url https://app.tingting.io/api/v1/auths/login/ \
  --header 'Content-Type: application/json' \
  --data '{"email": "test@gmail.com", "password": "test"}'
Response
{
  "has_logged_in": true,
  "message": "Login Successful"
}
The JWT access cookie set at login expires after 1 day. For long-lived integrations, generate a persistent API token in the next step.
3

Generate an API token

Use your access token from the login response to generate a long-lived API token. No request body is needed.
curl --request POST \
  --url https://app.tingting.io/api/v1/auths/generate-api-keys/ \
  --header 'Authorization: Bearer <your_access_token>'
Response
{
  "token": "7acbdcd5619e4b9eaaad8e41dabb7032298e1acdf8fbc99bfae70561b51cdee7",
  "message": "New API token generated successfully"
}
Store this token securely. You use it as your Authorization: Bearer value for all future requests.
4

Make an authenticated request

Verify your token works by calling the dashboard endpoint.
curl --request GET \
  --url https://app.tingting.io/api/v1/dashboard/ \
  --header 'Authorization: Bearer 7acbdcd5619e4b9eaaad8e41dabb7032298e1acdf8fbc99bfae70561b51cdee7'
A successful response returns your account summary — credit balance, campaign counts, and usage statistics.
5

Create your first campaign

With a working token, you’re ready to create a voice campaign. Head to the Campaign API reference to see the full request body, available voices, and scheduling options.