🚧

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 an Agent Knowledge item from either a text snippet
(source.source_type: snippet, requires title and
content) or a single URL (source.source_type: webpage,
requires url). The URL is normalized before the uniqueness
check; duplicate normalized URLs return 409 Conflict. The
resource is fetchable immediately; clients can poll its status
until indexing completes. For files, use
POST /agent-knowledge-files.

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

Scopes:
agents:write