This endpoint is in beta and subject to change.
A beta revision header (2026-10-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), a Q&A pair (source.source_type: qa, requires question and answer), or a folder (source.source_type: folder, requires title). Set parent_id to create the item inside a folder.
Titles are unique across every knowledge type; a webpage's title is its normalized URL and a Q&A item's title is its question. Returns 409 Conflict if the title is already in use, if an entire-site webpage overlaps an existing one, or if the company has reached its knowledge item limit. 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