🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-04-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Sends one user message into Customer Agent and returns every public
event Customer Agent emits in response.

Each call is one turn: the caller supplies the conversation
history with the new user message as the last entry, and
Customer Agent runs one routing and response cycle against it.
The response is non-streaming; the caller receives the entire
event list at once and renders it in order. Continue an existing
conversation by passing the optional conversation
relationship; omit it to start a new one.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes:
agents:write