🚧

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 a skill to Customer Agent.

Customer Agent will invoke this skill when the customer message
matches its description. Provide display_name,
description (summary of the skill's capabilities and when it
should be used), instructions (the system prompt the skill
uses to handle a turn), optional handoff (escalation
behavior), optional agent-tools relationship data, and
status. Set status: draft to stage without going live,
live to activate immediately. Customer Agent generates the
skill name and returns a prefixed custom id plus the generated
name attribute.

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

Scopes:
agents:write