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 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 references for named tools used as
{{tool ref=<name>}} in instructions, 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