Triton Relay API

curl "https://www.tritonrelay.app/api/v1/contacts?limit=10" \
  -H "Authorization: Bearer rly_your_key"

{
  "object": "contact",
  "id": "5b1f0c7e-2d4a-4f7e-9c1a-8e3b6d2f4a10",
  "displayName": "Kofi Mensah (Kofi M)",
  "name": "Kofi Mensah",
  "profileName": "Kofi M",
  "email": "kofi@example.com",
  "phone": "+233245550199",
  "source": "Messenger",
  "platform": "messenger",
  "status": "Qualified",
  "score": 82,
  "fields": [
    { "key": "address", "label": "Address", "type": "address", "value": "12 Oxford St, Osu, Accra" },
    { "key": "vin", "label": "VIN", "type": "vin", "value": "1HGCM82633A004352" },
    { "key": "car", "label": "Car", "type": "text", "value": "Honda Accord 2019" },
    { "key": "color", "label": "Color", "type": "text", "value": "Silver" }
  ],
  "values": {
    "name": "Kofi Mensah",
    "email": "kofi@example.com",
    "phone": "+233245550199",
    "address": "12 Oxford St, Osu, Accra",
    "vin": "1HGCM82633A004352",
    "car": "Honda Accord 2019",
    "color": "Silver"
  },
  "conversationId": "c2a7e0d4-91b3-4c55-8f0e-3a6d1b9e7f22",
  "lastCapturedAt": "2026-09-14T18:22:05.114Z",
  "createdAt": "2026-09-14T18:20:41.902311+00:00",
  "updatedAt": "2026-09-14T18:22:05.130244+00:00"
}

{
  "object": "list",
  "data": [ { "object": "contact", "id": "…", "values": { "name": "Kofi Mensah", "vin": "1HGCM82633A004352" } } ],
  "hasMore": true,
  "nextCursor": "WyIyMDI2LTA5LTE0VDE4OjIyOjA1…"
}

curl "https://www.tritonrelay.app/api/v1/contacts/5b1f0c7e-2d4a-4f7e-9c1a-8e3b6d2f4a10?include=history" \
  -H "Authorization: Bearer rly_your_key"

curl -X POST "https://www.tritonrelay.app/api/v1/contacts" \
  -H "Authorization: Bearer rly_your_write_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ama Owusu",
    "phone": "+233201234567",
    "source": "WhatsApp",
    "fields": { "vin": "1hgcm82633a004352", "car": "Toyota Corolla", "color": "Blue" }
  }'

{
  "object": "list",
  "data": [
    { "key": "name", "label": "Name", "type": "text", "builtIn": true, "assistants": ["Car rentals"] },
    { "key": "vin", "label": "VIN", "type": "vin", "builtIn": false, "assistants": ["Car rentals"] }
  ]
}

{ "error": { "code": "insufficient_scope", "message": "This API key can only read contacts. Create a key with read and write access." } }

import os, time, requests

API = "https://www.tritonrelay.app/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['TRITON_API_KEY']}"}
BOT_TOKEN = os.environ["TELEGRAM_BOT_TOKEN"]   # from @BotFather
CHAT_ID = os.environ["TELEGRAM_CHAT_ID"]       # the chat that gets new leads

since = "2026-01-01T00:00:00Z"  # store this somewhere durable in production

while True:
    cursor, newest = None, since
    while True:
        params = {"updated_since": since, "limit": 100}
        if cursor:
            params["cursor"] = cursor
        page = requests.get(f"{API}/contacts", headers=HEADERS, params=params, timeout=30).json()
        for contact in page["data"]:
            lines = [f"Lead: {contact['displayName']}"]
            lines += [f"{label}: {value}" for label, value in
                      (("Phone", contact["phone"]), ("Email", contact["email"])) if value]
            lines += [f"{field['label']}: {field['value']}" for field in contact["fields"]]
            requests.post(f"https://api.telegram.org/bot{BOT_TOKEN}/sendMessage",
                          json={"chat_id": CHAT_ID, "text": "\n".join(lines)}, timeout=30)
            newest = contact["updatedAt"]
        if not page["hasMore"]:
            break
        cursor = page["nextCursor"]
    since = newest
    time.sleep(60)

// Node 18+. Posts each new or updated lead to a Discord channel webhook.
const API = "https://www.tritonrelay.app/api/v1";
const headers = { Authorization: `Bearer ${process.env.TRITON_API_KEY}` };
let since = new Date().toISOString();

async function sync() {
  let cursor = null;
  let newest = since;
  do {
    const url = new URL(`${API}/contacts`);
    url.searchParams.set("updated_since", since);
    url.searchParams.set("limit", "100");
    if (cursor) url.searchParams.set("cursor", cursor);
    const page = await (await fetch(url, { headers })).json();

    for (const contact of page.data) {
      await fetch(process.env.DISCORD_WEBHOOK_URL, {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({
          embeds: [{
            title: contact.displayName,
            fields: Object.entries(contact.values).map(([key, value]) => ({
              name: contact.fields.find((f) => f.key === key)?.label ?? key,
              value,
              inline: true,
            })),
          }],
        }),
      });
      newest = contact.updatedAt;
    }
    cursor = page.hasMore ? page.nextCursor : null;
  } while (cursor);
  since = newest;
}

setInterval(sync, 60_000);

await fetch("https://www.tritonrelay.app/api/v1/contacts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TRITON_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone: message.from,            // e.g. "+233201234567"
    name: profile.name,
    source: "WhatsApp",
    fields: { address: answers.address, vin: answers.vin, car: answers.car, color: answers.color },
  }),
});