Integrate Telesto with your own in-house solutions or third-party services using our RESTful API. Perfect for custom integrations and automated workflows.

Prerequisites: Pro subscription and valid API key required for all endpoints.

What You Can Do

  • Products create, read, update and delete your catalogue
  • Stock by warehouse see exactly where each product's stock sits, not just the account total
  • Transactions move stock in and out, and read back the full ledger to reconcile against your own system
  • Categories, locations and suppliers full create, read, update and delete

API Reference

The complete reference documents every endpoint, parameter and response, with ready-made code samples in curl, PHP, Python, Node and Ruby. You can also send real requests to your own account straight from the page.

https://www.telesto.app/docs/api

Authentication

Send your API key in the Authorization header on every request. Send the raw key, with no Bearer prefix:

Authorization: YOUR_API_KEY

Rate Limits

100 requests per hour, counted per API key. Going over it blocks you for 15 minutes, and the response tells you how long to wait. Requests that fail authentication count against your IP address instead, so a wrong key never uses up your quota.

Best Practices

  • Store your API key securely, never in client-side code
  • Fetch large pages rather than making many small requests, and cache anything that does not change often
  • Respect the Retry-After header instead of retrying a rate-limited request immediately
  • When updating a record, send only the fields you want to change. Anything you leave out keeps its current value
  • If a stock transaction times out, check the transaction list before sending it again. Retrying blindly can move the same stock twice

Getting Started

  1. Ensure you have a Pro subscription
  2. Contact support to request API access and obtain your key
  3. Open the API reference and try a request straight from the page

Currently in Beta: We are actively expanding API endpoints and functionality. If you're interested in using the API or need specific endpoints, please contact our support team.