HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Create Conversation Context

🚧

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.

Attach background the caller already has to an existing conversation.

Unlike POST /api/customer-agent-responses, this never runs the agent or produces a reply -- it only records the context. Requires an open conversation, created via POST /api/customer-agent-conversations.

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

Scopes:
agents:write

OpenAPI Spec

Query Params
fields[customer-agent-conversation-context]
array of strings
fields[customer-agent-conversation-context]
Allowed:
Body Params

JSON:API request to attach a survey-response context to an existing conversation.

Unlike POST /api/customer-agent-responses, this never produces a reply -- it only records background the caller already has.

data
object
required
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