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.
Adds an Agent Knowledge item from a text snippet (source.source_type: snippet, requires title and content), a single URL (source.source_type: webpage, requires url), or a Q&A pair (source.source_type: qa, requires question and answer).
The URL is normalized before the uniqueness check; duplicate normalized URLs or duplicate Q&A questions 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