Update Folder

patch

https://a.klaviyo.com/api/folders/{id}

🚧
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.

Rename and/or move a folder.

attributes.name and relationships.parent are both optional and independently applied — send either or both in one call. Omit relationships.parent to leave it unchanged; send it as null to move the folder to root.

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

Scopes:
folders:write

OpenAPI Spec

Path Params

string

required

Query Params

additional-fields[folder]

array of strings

Request additional fields not included by default in the response. Supported values: 'child_count', 'item_count'

additional-fields[folder]

Allowed:

fields[folder]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-10-15.pre/reference/api-overview#sparse-fieldsets

fields[folder]

Allowed:

include

array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-10-15.pre/reference/api-overview#relationships

include

Allowed:

Body Params

Request to rename and/or move a folder.

name/parent are independently optional — send either, or both, to update just that part. Omit parent entirely to leave it unchanged; send parent: null to move the folder to root.

data

object

required

Headers

revision

string

required

Defaults to 2026-10-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language

Credentials

Header

Loading…

Response

Choose an example:

application/vnd.api+json

200Success

4XXClient Error

5XXServer Error