Skip to content
VTEX logo

Connectors / E-commerce · HTTP Connector

Automate VTEX with Tray.ai

Start handling an order, create a product and create a SKU in VTEX, and start a workflow when VTEX sends “Order status changed”.

What can you do with VTEX on Tray.ai?

VTEX is a commerce platform for brands and retailers, running online stores and marketplaces with catalog, pricing, checkout, orders and inventory management. Tray.ai connects to VTEX through the HTTP Connector, so your workflows can call the VTEX API alongside the rest of your stack.

  • When VTEX sends “Order status changed”, update the order record in your ERP.
  • Update inventory by warehouse when stock levels change in your warehouse system.
  • Create a product in VTEX when a new item is approved in your product information system.
  • Cancel an order when your fraud review team rejects it.
Connects through
HTTP Connector
Authentication
An API key in a request header

Set it up

Connect VTEX to Tray.ai

Each step uses VTEX's own API details, from its documentation.

Step 1

Save VTEX's API key

Save the key as a Tray.ai authentication. The HTTP Client puts it in the request header, read from $.auth. The key stays out of the workflow and out of the logs.

Step 2

Import a request from VTEX's docs

Add an HTTP Client step and paste a cURL example from VTEX's API docs. Tray.ai fills in the method, URL, headers, and query.

Step 3

Start with “List orders”

It's one of 16 documented actions, under Orders. The response comes back as data the next step can map into your other apps.

Step 4

Start workflows from VTEX events

Give VTEX the URL of a Tray.ai webhook trigger. “Order status changed” can then start a workflow.

Give your AI agents VTEX tools

Build an MCP server on VTEX in Agent Gateway and choose which actions your agents can call. Every call runs with access control and an audit trail. How Agent Gateway works

  • List orders
  • Create a product
  • Create a SKU
  • List brands
  • List inventory by SKU
  • Get an order
  • Start handling an order
  • Cancel an order

What the VTEX API covers

5 resources and 16 documented actions, each one a call the HTTP Connector can make from a Tray.ai workflow. Connecting it takes a few clicks: here's how.

Orders

  • List orders
  • Get an order
  • Start handling an order
  • Cancel an order

Products

  • Create a product
  • Get a product
  • Update a product

SKUs

  • Create a SKU
  • Get a SKU
  • Update a SKU

Brands

  • List brands
  • Create a brand
  • Update a brand
  • Delete a brand

Inventory

  • List inventory by SKU
  • Update inventory by warehouse

Events VTEX can send to a Tray.ai webhook trigger

  • Order status changed

Checked against VTEX's own documentation on 2026-11-03

developers.vtex.com/docs/api-reference

Frequently asked questions

What can a Tray.ai workflow do in VTEX?

+

The VTEX API documents 16 actions across 5 resources (Orders, Products, SKUs, Brands, Inventory). For example: List orders; Create a product; Create a SKU. A workflow can make any documented call through the HTTP Connector.

How does Tray.ai authenticate with VTEX?

+

The VTEX API uses an API key in a request header. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.

Which VTEX events can start a Tray.ai workflow?

+

VTEX sends one event to a webhook URL, for example: Order status changed. A Tray.ai webhook trigger receives them and starts a workflow.

See VTEX working against your stack.

We'll walk through a tailored demo with your systems plugged in.

Great — a couple more details

This helps us connect you with the right person. Optional, and you can skip it.