Skip to main content

​
Telemetron External API (ext-v1)

Synchronize customer and device ownership data to enable Telemetron to correlate device telemetry with customers for AI-powered support.
New to the integration? Start with API Getting Started.

​
Base URL

https://admin.telemetron.ai/api/ext-v1

​
Authentication

All requests require an API key in the x-api-key header: 
x-api-key: your_api_key_here
Get your API key: Dashboard → Integrations → scroll down to find your API key and copy it
Never expose API keys in client-side code or commit them to version control.

​
Endpoints

​
Customer Management

  • POST /customer/createOrUpdateCustomer - Create or update customer records
  • POST /customer/queryCustomer - Query customer by email
  • GET /customer/getCustomer/{id} - Get customer by ID

​
Device Management

  • POST /device - Create or update device records

​
Device Assignment

  • POST /deviceAssignment/assignDeviceToOwners - Assign device to one or more customers
  • POST /deviceAssignment/assignDevicesToOwner - Assign multiple devices to one customer
  • POST /deviceAssignment/unassignDeviceFromOwner - Remove device assignment
  • POST /deviceAssignment/unassignDevicesFromOwner - Remove multiple device assignments from one customer

​
Ticket Management

  • POST /ticket/createTicket - Create a new support ticket
Keep mappings synchronized. Update Telemetron immediately when customers register devices or transfer ownership.

​
Response Format

All responses are JSON. Success responses include success: true, error responses include error field. Success: 
{
  "success": true,
  "message": "Operation completed",
  "data": { }
}
Error: 
{
  "error": "Error description"
}

​
HTTP Status Codes

CodeMeaning
200Success
400Bad request (invalid/missing parameters)
401Unauthorized (invalid/missing API key)
404Resource not found
409Conflict (duplicate resource)
500Server error

​
How Device-Customer Mapping Works

  1. Device sends telemetry → Telemetron receives device data
  2. Mapping lookup → Uses your synced mappings to identify the customer
  3. AI diagnosis → Analyzes telemetry in customer context
  4. Intelligent support → Provides proactive support or alerts your team
Bottom line: Keep mappings current so telemetry reaches the right customers.