HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Update Brand Voice

🚧

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.

Update the brand voice for the authenticated company.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes:
brands:write

OpenAPI Spec

Path Params
string
required

The company ID. Must match the authenticated account.

Query Params
fields[brand-voice]
array of strings
fields[brand-voice]
Allowed:
Body Params

PATCH /api/brand-voice/{company_id} — JSON:API field-level partial update.

Per https://jsonapi.org/format/#crud-updating-resource-attributes, only
the top-level attributes present in the request body are replaced;
missing top-level fields are preserved. A client can patch just
tone_descriptors without disturbing language_patterns, and vice
versa.

A present top-level field is replaced wholesale (no recursive merge
into the list contents) — the underlying service treats
tone_descriptors and language_patterns as full-list replacements,
so partial-list edits must be done client-side by reading, modifying,
and writing the full list.

The path id must equal the auth context's company id; mismatches
return 404.

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