How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Klaviyo Forms API is one of 23 APIs that Klaviyo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Forms. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, an API reference, authentication docs, and rate-limit docs.

This API exposes 9 operations across 7 paths, and defines 186 schemas. It is described by OpenAPI 3.2.0, at version 2026-04-15.

Requests are made against a single base URL, https://a.klaviyo.com.

9 operations 7 paths 186 schemas 1 DELETE7 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026-04-15
Base URL
https://a.klaviyo.com
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Klaviyo Forms API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Klaviyo-API-Key). By default, every request must be authenticated.

  • Klaviyo-API-Key — Private key authentication for /api/ endpoints is performed by setting the Authorization header to Klaviyo-API-Key your-private-api-key For more information pl…

Paths & Operations 9

Across 7 paths, the API surfaces 9 operations — 1 DELETE, 7 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Forms 9

forms

GET
/api/forms
Get Forms
get_forms 6 params → 2004XX5XX
POST
/api/forms
Create Form
create_form 1 param body → 2014XX5XX
GET
/api/forms/{id}
Get Form
get_form 3 params → 2004XX5XX
DELETE
/api/forms/{id}
Delete Form
delete_form 2 params → 2044XX5XX
GET
/api/form-versions/{id}
Get Form Version
get_form_version 3 params → 2004XX5XX
GET
/api/forms/{id}/form-versions
Get Versions for Form
get_versions_for_form 7 params → 2004XX5XX
GET
/api/forms/{id}/relationships/form-versions
Get Version IDs for Form
get_version_ids_for_form 6 params → 2004XX5XX
GET
/api/form-versions/{id}/form
Get Form for Form Version
get_form_for_form_version 3 params → 2004XX5XX
GET
/api/form-versions/{id}/relationships/form
Get Form ID for Form Version
get_form_id_for_form_version 2 params → 2004XX5XX

Schemas 186

The contract defines 186 schemas that model the data the API accepts and returns. The most detailed are VersionStyles (17 properties), Version (13 properties), ButtonStyles (11 properties), RichTextStyle (10 properties). Each schema is shown below with its type and property counts.

GetFormVersionsRelationshipsResponseCollection
object
2 properties 1 required
CartValueProperties
object
2 properties
SkipToSuccessProperties
object
RichTextStyle
object
10 properties
TextStyles
object
2 properties
ResendOptInCode
object
4 properties 1 required
Padding
object
4 properties
GoToInbox
object
4 properties 1 required
DropdownProperties
object
9 properties 2 required
ReviewProperties
object
10 properties
SubscribeViaWhatsAppProperties
object
3 properties 3 required
SignupCounterStyles
object
2 properties
VersionProperties
object
5 properties
PropertyOption
object
2 properties 2 required
CloseProperties
object
1 property
GetFormVersionResponse
object
2 properties 1 required
RedirectProperties
object
3 properties 1 required
ErrorMessages
object
2 properties
FormVersionEnum
string
Delay
object
3 properties 1 required
Channel
object
3 properties 2 required
BackgroundImageStyles
object
5 properties
ExitIntent
object
3 properties 1 required
SpinToWinStyles
object
9 properties
SubmitBackInStock
object
4 properties 1 required
RatingStyle
object
6 properties
CollectionLinks
object
5 properties 1 required
UniqueCouponConfig
object
5 properties 1 required
Checkboxes
object
4 properties 2 required
CartProduct
object
3 properties 1 required
AgeGateProperties
object
10 properties
Location
object
3 properties 2 required
CouponProperties
object
4 properties 1 required
QuoteStyle
object
7 properties
CartProductProperties
object
2 properties
CartItemCountProperties
object
2 properties
CloseButtonStyle
object
6 properties
PostEncodedFormResponse
object
2 properties 1 required
RichTextStyles
object
8 properties
CheckboxesStyles
object
4 properties
SMSDisclosureStyles
object
4 properties
ObjectLinks
object
1 property 1 required
ColumnV0
object
3 properties
FormEnum
string
CouponStyles
object
5 properties
ColumnStyles
object
2 properties
RadioButtonsProperties
object
9 properties 2 required
FormCreateQuery
object
1 property 1 required
ButtonStyles
object
11 properties
FormVersionResponseObjectResource
object
4 properties 4 required
PhoneNumberConsentChannelSettings
object
1 property
BackInStockDynamicButtonBorderStyles
object
4 properties
Button
object
5 properties 2 required
ListsAndSegmentsProperties
object
2 properties
SMSDisclosureAccountDefault
object
2 properties 1 required
AgeGate
object
5 properties 2 required
SideImageSettings
object
3 properties
GetEncodedFormResponse
object
2 properties 1 required
SubscribeViaSMS
object
4 properties 2 required
ProfileEventTracked
object
3 properties 2 required
EmailProperties
object
8 properties
OpenForm
object
4 properties 2 required
CartItemCount
object
3 properties 1 required
FormVersionABTest
object
1 property 1 required
IdentifiedProfiles
object
3 properties 1 required
RowV0
object
2 properties 1 required
Image
object
5 properties 2 required
SkipToSuccess
object
4 properties 2 required
HTMLText
object
4 properties 1 required
ButtonDropShadowStyles
object
5 properties
Redirect
object
4 properties 3 required
TeaserStyles
object
6 properties
SpinToWinProperties
object
4 properties 1 required
SMSConsentCheckboxStyles
object
3 properties
DropShadow
object
3 properties
BackInStockProperties
object
2 properties
Date
object
4 properties 2 required
BackInStockEmailConsentCheckboxStyles
object
3 properties
ImageAssetProperties
object
5 properties
CheckboxesProperties
object
9 properties 2 required
ReviewStyles
object
6 properties
PreviouslySubmitted
object
3 properties 1 required
HTMLTextProperties
object
3 properties
OptInCodeStyles
object
2 properties
Close
object
4 properties 2 required
PageVisits
object
3 properties 1 required
BackInStock
object
3 properties 1 required
CustomCss
object
2 properties
BackInStockEmailConsentCheckbox
object
4 properties 2 required
DateStyles
object
2 properties
ImageStyles
object
5 properties
SMSDisclosure
object
4 properties 1 required
PromotionalSMSSubscription
object
4 properties 1 required
Step
object
4 properties 1 required
EmailStyles
object
2 properties
SubscribeViaSMSProperties
object
3 properties 3 required
LocationProperties
object
2 properties
Device
object
3 properties 1 required
Teaser
object
10 properties 1 required
GetFormResponse
object
2 properties 1 required
SubmitBackInStockProperties
object
1 property
FormCreateQueryResourceObject
object
2 properties 2 required
DelayProperties
object
1 property
PhoneNumber
object
4 properties 2 required
URLPatterns
object
3 properties 1 required
UnidentifiedProfiles
object
3 properties 1 required
InputStyles
object
10 properties
SubscribeViaWhatsApp
object
4 properties 2 required
SignupCounterProperties
object
5 properties 3 required
DeviceProperties
object
1 property
RichTextMargin
object
4 properties
GetFormVersionFormRelationshipResponse
object
2 properties 1 required
RelationshipLinks
object
2 properties 2 required
TextStyleV0
object
7 properties
SignupCounter
object
4 properties 2 required
NextStep
object
4 properties 2 required
OptInCode
object
4 properties 2 required
PhoneNumberStyles
object
2 properties
AfterCloseTimeout
object
3 properties 1 required
GetFormVersionResponseCollection
object
2 properties 1 required
ImageProperties
object
4 properties 1 required
AfterCloseTimeoutProperties
object
1 property
BackInStockDynamicButtonData
object
4 properties
ButtonProperties
object
4 properties 1 required
Version
object
13 properties 1 required
LinkStyles
object
2 properties
BackInStockDynamicButtonDropShadowStyles
object
5 properties
ScrollProperties
object
1 property
Review
object
4 properties 2 required
OpenFormProperties
object
2 properties 1 required
CountdownTimerProperties
object
5 properties 1 required
Dropdown
object
4 properties 2 required
BorderStyle
object
4 properties
SMSDisclosureProperties
object
3 properties
OptInCodeProperties
object
8 properties
AdditionalField
object
2 properties 2 required
ReviewerNameStyle
object
8 properties
FormDefinition
object
1 property 1 required
Coupon
object
4 properties 2 required
PhoneNumberProperties
object
10 properties
SMSConsentCheckboxProperties
object
10 properties 1 required
VersionStyles
object
17 properties
TextProperties
object
8 properties 1 required
PageVisitsProperties
object
1 property
ChannelProperties
object
1 property 1 required
ListsAndSegments
object
3 properties 2 required
FixedTimerConfiguration
object
3 properties 2 required
GetFormResponseCollection
object
2 properties 1 required
MobileOverlay
object
2 properties
ChannelSettings
object
2 properties
SMSConsentCheckbox
object
4 properties 2 required
ProfileEventTrackedProperties
object
1 property 1 required
AgeGateStyles
object
2 properties
DateProperties
object
9 properties 1 required
RadioButtons
object
4 properties 2 required
Scroll
object
3 properties 1 required
SpinToWinSliceStyle
object
2 properties
TriggerBaseProperties
object
BackInStockDynamicButtonStyles
object
7 properties
BackgroundImage
object
2 properties 1 required
SpinToWinSliceConfig
object
3 properties 3 required
BannerStyles
object
3 properties
SpinToWin
object
4 properties 2 required
URLPatternsProperties
object
2 properties
RadioButtonsStyles
object
4 properties
CartValue
object
3 properties 1 required
BackInStockDynamicButtonTextStyles
object
7 properties
HTMLTextStyles
object
2 properties
StaticCouponConfig
object
2 properties 1 required
CountdownTimerStyles
object
6 properties
NextStepProperties
object
1 property
CountdownTimer
object
4 properties 2 required
VariableTimerConfiguration
object
4 properties 4 required
Margin
object
4 properties
DropdownStyles
object
2 properties
SubmitOptInCode
object
4 properties 1 required
FormResponseObjectResource
object
5 properties 4 required
SMSDisclosureTextStyle
object
7 properties
Text
object
4 properties 2 required
Email
object
4 properties 2 required
DynamicButton
object
3 properties 2 required
CustomJavascript
object
3 properties 1 required
EncodedFormResponseObjectResource
object
4 properties 4 required
ImageDropShadowStyles
object
5 properties
BackInStockEmailConsentCheckboxProperties
object
9 properties 1 required
SMSDisclosureCustom
object
5 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-forms-api-openapi.yml Raw ↑

Other APIs Klaviyo publishes across the network.

Klaviyo Accounts API
Klaviyo Campaigns API
Klaviyo Catalogs API
Klaviyo Client API
Klaviyo Conversations API
Klaviyo Coupons API
Klaviyo Custom Objects API
Klaviyo Data Privacy API
Klaviyo Events API
Klaviyo Flows API
Klaviyo Images API
Klaviyo Lists API
Where this information came from

This is an independent, third-party profile of Klaviyo Forms API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.