HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Get Customer Agents

🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-07-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 the Customer Agent for the calling company.

There is at most one Customer Agent per company, so the array holds one Customer Agent, or is empty if Customer Agent is not enabled for the account. Use this to look up the Customer Agent's id before calling Get or Update Customer Agent.

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

Scopes:
agents:read

OpenAPI Spec

Query Params
fields[customer-agent]
array of strings
fields[customer-agent]
Allowed:
Headers
string
required
Defaults to 2026-07-15.pre

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

Responses

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