Skip to main content

​
What This API Does

Telemetron provides AI-powered support for hardware companies. This API lets you sync three things:
  1. Devices - Your hardware products that send telemetry
  2. Customers - Your end users who own devices
  3. Device Assignments - Mappings that connect devices to customers
When devices send telemetry to Telemetron, we use these mappings to identify which customer owns the device and provide intelligent support.
Flow: Device sends telemetry → Telemetron looks up assignment → Identifies customer → Provides AI-powered support

​
Quick Integration

1

Get Your API Key

Log into your Dashboard and go to the Integrations page → scroll down to find your API key and copy itAll API requests require your key in the header:
x-api-key: your_api_key_here
Keep your API key secure. Never expose it in client-side code or commit it to version control.
2

Create a Customer

Sync customer information to Telemetron:
curl -X POST https://admin.telemetron.ai/api/ext-v1/customer/createOrUpdateCustomer \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "+1234567890",
    "address": "123 Main St, City, State 12345"
  }'
3

Assign a Device to the Customer

Create the device-to-customer mapping for telemetry routing:
curl -X POST https://admin.telemetron.ai/api/ext-v1/deviceAssignment/assignDeviceToOwners \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "deviceIdentifier": "SN-12345-ABCDE",
    "customerEmails": ["john.doe@example.com"],
    "autoCreateDevice": true,
    "deviceType": "Thermostat"
  }'
Set autoCreateDevice: true to automatically create the device if it doesn’t exist. When using this option, you must provide deviceType.
4

Done

Telemetry from SN-12345-ABCDE now routes to john.doe@example.com for AI-powered support.

​
Common Scenarios

  1. Customer completes purchase in your system
  2. Call Create Customer if the customer is new
  3. Call Assign Device with autoCreateDevice: true and deviceType
  4. Telemetry from this device now routes to this customer
  1. Call Unassign Device with the old owner’s email
  2. Call Create Customer for the new owner if needed
  3. Call Assign Device with the new owner’s email
  4. Telemetry now routes to the new owner
  1. Ensure all family members exist as customers
  2. Call Assign Device with an array of all family member emails
  3. All family members receive support alerts for this device

​
API Endpoints

Customer Management

Create, update, and query customer records.

Device Management

Register and update devices.

Device Assignment

Map devices to customers for telemetry routing.

API Reference Overview

Review the base URL, authentication model, response format, and endpoint catalog.