🚧

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.

Adds a new external HTTP tool Customer Agent skills can call.

Provide protocol details (method, URL, query parameter, header,
and body templates using Jinja-style {{variable_name}}
syntax) and declare the variables those templates reference. The
runtime uses variables to determine which values are
supplied at call time. To reference a secret, include a variable
with source: secret and value set to the agent- secret id. The tool isn't directly callable until bound to a
skill with PATCH /agent-skills/{id}.

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

Scopes:
agents:write