Tray API: orders, products and customers with AI agents
Tray is a Brazilian e-commerce platform with a REST API for connecting the store to ERPs, marketplaces and hubs. Store owners and integrators use it to sync orders, catalog and stock. Access is through an application authorized by the store, which generates the access keys.
What the Tray API offers
Orders
List and look up orders, and update the status and the tracking code.
Products and variations
Create and edit products, variations, categories and images.
Stock and prices
Update stock and price per product or variation.
Customers
Look up and update customer records.
Coupons and shipping
Check shipping methods and manage coupons.
Notifications
Receive alerts about new orders and changes through a notification URL.
How to access the Tray API
- With your company’s credentialsThe store authorizes an application registered in Tray, which receives a code used to generate an access token and a refresh token.
- Tray applies request limits per store, so the agent uses notifications instead of polling all the time.
- Customer and address data fall under Brazil's data-protection law (LGPD).
- Bulk price changes need approval.
Official documentation: developers.tray.com.br
What an iTeam agent does with the Tray API
Tracking sent without being asked
When the order ships, the agent records the tracking code in Tray and tells the customer on WhatsApp.
Pending orders and carts
Orders awaiting payment get a reminder from the agent with the payment link.
A catalog without errors
The agent reviews products with no photo, no weight or a short description and proposes fixes.
Stock in sync
Mismatches between the ERP and Tray become an alert with the list of affected SKUs.
From the credential to the agent at work, with approval
Authorize the application in the store
Register the integration application in Tray and authorize it in the store to generate the access keys.
Register the credential in the iTeam vault
The Tray credential stays in the iTeam vault, out of prompts and spreadsheets. Each agent gets only the actions it needs (read orders, update tracking, adjust stock), and anything that writes data goes through approval.
Test with human approval
Before release, update the tracking code of a test order. In the first weeks, write actions stay under approval and everything is in the audit trail.
Ready-made AI teams for this work
WhatsApp customer service
Customers write at 11 p.m. and on Sundays. This team replies in seconds, with your prices and policies, and calls a person when it should.
Help desk support team
It reads each ticket, finds the answer in your docs and past replies, and drafts a response your agents can send or improve.
AI phone receptionist
It answers the phone, books the visit in your calendar and sends your team a short note about every call.
Online store support team
It looks up the real order in Shopify or WooCommerce and answers tracking, return and exchange questions in seconds.
Customer success team
It reads usage, tickets and CRM notes every week and tells your team which accounts need a call, and why.
Customer feedback analysis
It reads every comment, finds the themes behind the scores and tells each area what customers are asking it to fix.
Questions about the Tray API
Is the Tray API free?
API use is included for Tray stores, within the platform's limits; third-party applications may have their own cost.
Do I need to write code to use the Tray API with iTeam?
Not necessarily. iTeam's HTTP tool learns the Tray API endpoints from the documentation, and the deployment team sets up credentials, permissions and the process. Your team validates the result.
Is the Tray API useful for connecting to a marketplace?
Yes, it is the foundation of the hubs and ERPs that connect Tray to marketplaces. The iTeam agent uses the same API to follow the operation.
