HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Get Agent Tools

🚧

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.

Returns every external tool (HTTP API endpoint) Customer Agent
skills can call.

Each tool has an id, display name, protocol details (method, URL
template), authentication setup, and any referenced secrets. Use
this before creating a new tool to avoid duplicates, or before
binding a tool to a skill to confirm the tool exists.

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

Scopes:
agents:read

Query Params
fields[agent-tool]
array of strings
fields[agent-tool]
string

For more information please visit https://developers.klaviyo.com/en/v2026-04-15.pre/reference/api-overview#filtering
Allowed field(s)/operator(s):
name: contains
tool_type: equals
created_at: equals, greater-or-equal, less-or-equal
updated_at: equals, greater-or-equal, less-or-equal

integer
1 to 100
Defaults to 50

Default: 50. Min: 1. Max: 100.

string

Page cursor

Headers
string
required
Defaults to 2026-04-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json