Quickstart

Building in Node.js or PHP? Use an official SDK instead — it handles authentication, retries, and error types for you.

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"

const res = await fetch("https://api.nateq.io/api/v1/conversations", {
  headers: { Authorization: "Bearer tg_live_your_key_here" },
});
const body = await res.json();
console.log(body.data);

import requests

res = requests.get(
    "https://api.nateq.io/api/v1/conversations",
    headers={"Authorization": "Bearer tg_live_your_key_here"},
)
print(res.json()["data"])

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.

Get Started

SDKs

Platform

1. Create an API key

2. Make a request

3. Read the response

​1. Create an API key

​2. Make a request

​3. Read the response

1. Create an API key

2. Make a request

3. Read the response