HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Update Form

🚧

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.

Update a form's name or complete editable definition.

Only name and definition may be supplied. Omitted attributes retain their values. The channel, version IDs, and live versions cannot change. Omitted editable entities are deleted from a supplied definition. A definition from an earlier GET can overwrite subsequent edits; this endpoint does not provide optimistic concurrency checks.

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

Scopes:
forms:write

OpenAPI Spec

Path Params
string
required

The ID of the form.

Query Params
fields[form]
array of strings
fields[form]
Body Params

Update a form's name or editable definition.

data
object
required
Headers
string
required
Defaults to 2026-10-15.pre

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

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json