Skip to main content

1. Create an API key

In your Nateq dashboard, open Settings → Developers → API Keys and create a key. Choose the scopes it needs (for example conversations:read). You’ll see the key once — copy it somewhere safe.
  • Production keys start with tg_live_
  • Sandbox keys start with tg_test_

2. Make a request

Authenticate by passing the key as a Bearer token in the Authorization header.
curl https://api.nateq.io/api/v1/conversations \
  -H "Authorization: Bearer tg_live_your_key_here"

3. Read the response

Every response follows the same envelope:
{
  "success": true,
  "data": [ /* ... */ ],
  "meta": { "total": 42 }
}
On failure, success is false and error carries a machine-readable code:
{
  "success": false,
  "error": { "code": "INSUFFICIENT_SCOPE", "message": "API key does not have the required scope" }
}
That’s it — you’re authenticated. Head to the API Reference to explore every endpoint with a live console.