I am attempting to create the form through the API, but I am encountering the following error:
- Home
- Meet the Champions
- Developer Group
- Issue while creating form via API
Issue while creating form via API
- November 18, 2025
- 10 replies
- 67 views
- Problem Solver I
10 replies
- Expert Problem Solver I
- November 18, 2025
Hey
Cadence / Book a demo
- Author
- Problem Solver I
- November 18, 2025
Hey
- Expert Problem Solver I
- November 18, 2025
Hey
I’m curious what’s in the form you’re trying to create, though. I wouldn’t be surprised if some functionality (e.g. AB tests) isn’t supported by the API and is leading to the 500 error here. That’s why seeing the actual payload you’re using here might help to pinpoint the issue.
It’s also possible that this is a temporary issue + Klaviyo’s API is currently impacted by the ongoing Cloudflare outage.
- Author
- Problem Solver I
- November 19, 2025
{
"data": {
"type": "form",
"attributes": {
"status": "draft",
"ab_test": false,
"name": "WelcomeEmail",
"definition": {
"versions": [
{
"steps": [
{
"columns": [
{
"rows": [
{
"blocks": [
{
"type": "image",
"styles": {
"horizontal_alignment": "center",
"width": 200,
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"image": {
"id": 233893404
},
"additional_fields": null
},
"action": null
}
]
},
{
"blocks": [
{
"type": "email",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"label": "Email",
"show_label": false,
"placeholder": "Email",
"required": true,
"error_messages": null,
"property_name": "$email"
}
}
]
},
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 0,
"bottom": 0
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "<p style=\"line-height: 92%; text-align: left;\" data-prosemirror-content-type=\"node\" data-prosemirror-node-name=\"paragraph\" data-prosemirror-node-block=\"true\" data-pm-slice=\"1 1 []\"><span style=\"font-family: Raleway, Helvetica, Arial, sans-serif; font-weight: 400; font-style: normal; font-size: 12px; color: rgb(19, 12, 1);\">By entering your email address and submitting this form, you consent to receive marketing communications and/or targeted advertising from Eclaira. We process your personal data as stated in our Privacy Policy. You may withdraw your consent or manage your preferences at any time by clicking the unsubscribe link at the bottom of our marketing emails.</span></p>"
}
}
]
},
{
"blocks": [
{
"type": "button",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": "rgba(255,255,255,0)",
"width": "fill",
"height": 54,
"hover_background_color": null,
"hover_text_color": null,
"border_styles": {
"radius": 6,
"color": "#211D1C",
"style": null,
"thickness": 3
},
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 18,
"font_weight": 700,
"text_color": "#FFFFFF",
"character_spacing": 0
},
"color": "#211D1C"
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"label": "Continue",
"additional_fields": [
{
"name": "$source",
"value": "UC| WelcomeEmail"
}
]
},
"action": {
"submit": true,
"type": "next_step",
"properties": {
"list_id": "RMYivz"
}
}
}
]
}
],
"styles": null
},
{
"rows": [],
"styles": {
"background_image": {
"styles": {
"horizontal_alignment": "center",
"width": 583,
"position": "cover",
"vertical_alignment": "center",
"custom_width": 488
},
"properties": {
"id": 233891000
}
},
"background_color": null
}
}
],
"name": null,
"steps": null
},
{
"columns": [
{
"rows": [
{
"blocks": [
{
"type": "image",
"styles": {
"horizontal_alignment": "center",
"width": 200,
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"image": {
"id": 233893076
},
"additional_fields": null
},
"action": null
}
]
},
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 0
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"><span class=\"ql-font-poppins\" style=\"color: rgb(55, 63, 71); font-size: 28px; font-family: Poppins, Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: bold; font-style: normal;\">Want SMS-alerts?</span></p>\n<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"> </p>"
}
}
]
},
{
"blocks": [
{
"type": "sms_disclosure",
"styles": {
"padding": {
"left": 10,
"right": 10,
"top": 10,
"bottom": 10
},
"background_color": null,
"link_styles": {
"font_family": "'Poppins-Klaviyo-Hosted', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 10,
"font_weight": 400,
"text_color": "#0066cc",
"character_spacing": 0
},
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 10,
"font_weight": 400,
"text_color": "#130C01",
"character_spacing": 0
}
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": {
"type": "account_default",
"html": "<p>By submitting this form, you consent to receive informational (e.g., order updates) and/or marketing texts (e.g., cart reminders) from Theorem Digital including texts sent by autodialer. Consent is not a condition of purchase. Msg & data rates may apply. Msg frequency varies. Unsubscribe at any time by replying STOP or clicking the unsubscribe link (where available). <a href=\"www.privacypolicy.com\">Privacy Policy</a> & <a href=\"www.tearmsandservices.com\">Terms</a>.</p>"
}
}
}
]
},
{
"blocks": [
{
"type": "button",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null,
"width": "fill",
"height": 60,
"hover_background_color": null,
"hover_text_color": null,
"border_styles": {
"radius": 2,
"color": null,
"style": null,
"thickness": null
},
"text_styles": {
"font_family": "'Poppins-Klaviyo-Hosted', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 18,
"font_weight": 700,
"text_color": "#000000",
"character_spacing": 0
},
"color": "rgba(0,0,0,1)"
},
"properties": {
"display_device": [
"mobile"
],
"label": "Subscribe via SMS",
"additional_fields": [
{
"name": "$source",
"value": "UC| WelcomeEmail"
}
]
},
"action": {
"submit": true,
"type": "subscribe_via_sms",
"properties": {
"opt_in_keyword": "JOIN",
"opt_in_message": "Send this text to subscribe to recurring automated personalized marketing alerts (e.g. special promotions, cart reminders) from Klaviyo Library",
"sending_number": "+18662592836"
}
}
}
]
},
{
"blocks": [
{
"type": "phone_number",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop"
],
"label": null,
"show_label": false,
"placeholder": "Phone Number",
"required": false,
"error_messages": null,
"property_name": "$phone_number",
"sms_consent_type": [
"promotional",
"transactional"
]
}
},
{
"type": "button",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null,
"width": "fit",
"height": 50,
"hover_background_color": null,
"hover_text_color": null,
"border_styles": {
"radius": 6,
"color": "#211D1C",
"style": null,
"thickness": 2
},
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 20,
"font_weight": 700,
"text_color": "#000000",
"character_spacing": 0
},
"color": "#211D1C"
},
"properties": {
"display_device": [
"desktop"
],
"label": "Send",
"additional_fields": [
{
"name": "$source",
"value": "UC| WelcomeEmail"
}
]
},
"action": {
"submit": true,
"type": "next_step",
"properties": {
"list_id": "RMYivz"
}
}
}
]
},
{
"blocks": [
{
"type": "promotional_sms_checkbox",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null,
"horizontal_alignment": "left"
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"label": "",
"show_label": false,
"error_messages": null,
"required": false,
"property_name": "opt_in_promotional_sms",
"checkbox_text": "Check this box to also receive promotional marketing texts (Exclusive text messaging-only deals, offers, and coupons).",
"placeholder": null
}
}
]
}
],
"styles": null
},
{
"rows": [],
"styles": {
"background_image": {
"styles": {
"horizontal_alignment": "center",
"width": 823,
"position": "custom",
"vertical_alignment": "top",
"custom_width": 510
},
"properties": {
"id": 233891938
}
},
"background_color": null
}
}
],
"name": "SMS",
"steps": null
},
{
"columns": [
{
"rows": [
{
"blocks": [
{
"type": "image",
"styles": {
"horizontal_alignment": "center",
"width": null,
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"image": {
"id": 65984952
},
"additional_fields": null
},
"action": null
}
]
},
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"><span class=\"ql-font-poppins\" style=\"font-size: 28px; color: rgb(55, 63, 71); font-family: Poppins, Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: bold; font-style: normal;\">Thanks for signing up!</span></p>"
}
}
]
},
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"><span class=\"ql-font-poppins\" style=\"color: rgb(51, 51, 51); font-size: 18px; font-family: Poppins, Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400; font-style: normal;\">Check your mobile device and inbox to confirm your subscription.</span></p>"
}
}
]
},
{
"blocks": [
{
"type": "button",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null,
"width": "fill",
"height": 56,
"hover_background_color": null,
"hover_text_color": null,
"border_styles": {
"radius": 2,
"color": null,
"style": null,
"thickness": null
},
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 20,
"font_weight": 400,
"text_color": "#000000",
"character_spacing": 0
},
"color": "#211D1C"
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"label": "Go to inbox",
"additional_fields": [
{
"name": "$source",
"value": "UC| WelcomeEmail"
}
]
},
"action": {
"submit": true,
"type": "go_to_inbox",
"properties": null
}
}
]
}
],
"styles": null
},
{
"rows": [],
"styles": {
"background_image": {
"styles": {
"horizontal_alignment": "left",
"width": 342,
"position": "custom",
"vertical_alignment": "center",
"custom_width": 500
},
"properties": {
"id": 233895303
}
},
"background_color": null
}
}
],
"name": null,
"steps": null
}
],
"triggers": [
{
"type": "after_close_or_submit_timeout",
"properties": {
"timeout_days": 5
}
}
],
"teasers": [
{
"content": "<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"><span style=\"font-size: 18px; color: rgb(0, 0, 0); font-family: Poppins, Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: bold; font-style: normal;\">Subscribe Us!</span></p>",
"display_order": "before_and_after",
"teaser_type": "rectangle",
"location": "bottom_left",
"size": "medium",
"custom_size": null,
"styles": {
"background_color": "rgba(212,184,134)",
"drop_shadow": {
"enabled": true,
"blur": 30,
"color": "rgba(0,0,0,0.15)"
},
"corner_radius": 4,
"background_image": null,
"close_button": {
"background_color": "#000000",
"outline_color": "#FFFFFF",
"color": "#FFFFFF",
"stroke": 2,
"size": 20,
"margin": {
"left": 16,
"right": 16,
"top": 16,
"bottom": 16
}
},
"margin": {
"left": 20,
"right": 0,
"top": 0,
"bottom": 0
}
},
"close_button": false,
"device_type": "both"
}
],
"dynamic_button": null,
"name": "Default Flyout",
"styles": {
"wrap_content": false,
"border_styles": {
"radius": 4,
"color": "#000000",
"style": null,
"thickness": 0
},
"close_button": {
"background_color": "rgba(255,255,255,1)",
"outline_color": "rgba(255,255,255,0)",
"color": "#373F47",
"stroke": 1,
"size": 35,
"margin": {
"left": 8,
"right": 8,
"top": 8,
"bottom": 8
}
},
"margin": {
"left": 20,
"right": 20,
"top": 20,
"bottom": 20
},
"padding": {
"left": 24,
"right": 24,
"top": 0,
"bottom": 0
},
"minimum_height": 540,
"width": "custom",
"custom_width": 800,
"background_image": null,
"background_color": "rgba(212,184,134)",
"input_styles": {
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 16,
"font_weight": 400,
"text_color": "#000000",
"character_spacing": 0
},
"label_color": "#000000",
"text_color": "#000000",
"placeholder_color": "#767676",
"background_color": "#FFFFFF",
"border_color": "#606A72",
"border_focus_color": "#000000",
"focus_outline_color": "#1C65AD",
"corner_radius": 4,
"field_height": 50
},
"drop_shadow": {
"enabled": true,
"blur": 30,
"color": "rgba(0,0,0,0.15)"
},
"overlay_color": "rgba(20,20,20,0.6)",
"rich_text_styles": {
"body": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 16,
"font_weight": 400,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"link": {
"color": "#0066cc",
"decoration": "underline"
},
"h1": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 48,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h2": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 36,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h3": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 28,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h4": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 20,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h5": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 13,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h6": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 11,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
}
},
"mobile_overlay": {
"color": "rgba(20, 20, 20, 0.5)",
"enabled": false
},
"banner_styles": null
},
"properties": {
"side_image_settings": {
"size": "medium",
"alignment": "right",
"device_type": [
"desktop",
"mobile"
]
},
"click_outside_to_close": [
"mobile"
],
"rule_based_trigger_evaluation": "any",
"record_utm_params_on_submit": false,
"show_close_button": true
},
"type": "popup",
"location": null,
"status": "draft",
"ab_test": true,
"specialties": []
},
{
"steps": [
{
"columns": [
{
"rows": [
{
"blocks": [
{
"type": "image",
"styles": {
"horizontal_alignment": "center",
"width": 200,
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"image": {
"id": 233893404
},
"additional_fields": null
},
"action": null
}
]
},
{
"blocks": [
{
"type": "email",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"label": "Email",
"show_label": false,
"placeholder": "Email",
"required": true,
"error_messages": null,
"property_name": "$email"
}
}
]
},
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 0,
"bottom": 0
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "<p style=\"line-height: 92%; text-align: left;\" data-prosemirror-content-type=\"node\" data-prosemirror-node-name=\"paragraph\" data-prosemirror-node-block=\"true\" data-pm-slice=\"1 1 []\"><span style=\"font-family: Raleway, Helvetica, Arial, sans-serif; font-weight: 400; font-style: normal; font-size: 12px; color: rgb(19, 12, 1);\">By entering your email address and submitting this form, you consent to receive marketing communications and/or targeted advertising from Eclaira. We process your personal data as stated in our Privacy Policy. You may withdraw your consent or manage your preferences at any time by clicking the unsubscribe link at the bottom of our marketing emails.</span></p>"
}
}
]
},
{
"blocks": [
{
"type": "button",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": "rgba(255,255,255,0)",
"width": "fill",
"height": 54,
"hover_background_color": null,
"hover_text_color": null,
"border_styles": {
"radius": 6,
"color": "#211D1C",
"style": null,
"thickness": 3
},
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 18,
"font_weight": 700,
"text_color": "#FFFFFF",
"character_spacing": 0
},
"color": "#211D1C"
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"label": "Continue",
"additional_fields": [
{
"name": "$source",
"value": "UC| WelcomeEmail"
}
]
},
"action": {
"submit": true,
"type": "next_step",
"properties": {
"list_id": "RMYivz"
}
}
}
]
}
],
"styles": null
},
{
"rows": [],
"styles": {
"background_image": {
"styles": {
"horizontal_alignment": "center",
"width": 583,
"position": "cover",
"vertical_alignment": "center",
"custom_width": 488
},
"properties": {
"id": 233891000
}
},
"background_color": null
}
}
],
"name": null,
"steps": null
},
{
"columns": [
{
"rows": [
{
"blocks": [
{
"type": "image",
"styles": {
"horizontal_alignment": "center",
"width": 200,
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"image": {
"id": 233893076
},
"additional_fields": null
},
"action": null
}
]
},
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 0
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"><span class=\"ql-font-poppins\" style=\"color: rgb(55, 63, 71); font-size: 28px; font-family: Poppins, Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: bold; font-style: normal;\">Want SMS-alerts?</span></p>\n<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"> </p>"
}
}
]
},
{
"blocks": [
{
"type": "sms_disclosure",
"styles": {
"padding": {
"left": 10,
"right": 10,
"top": 10,
"bottom": 10
},
"background_color": null,
"link_styles": {
"font_family": "'Poppins-Klaviyo-Hosted', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 10,
"font_weight": 400,
"text_color": "#0066cc",
"character_spacing": 0
},
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 10,
"font_weight": 400,
"text_color": "#130C01",
"character_spacing": 0
}
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": {
"type": "account_default",
"html": "<p>By submitting this form, you consent to receive informational (e.g., order updates) and/or marketing texts (e.g., cart reminders) from Theorem Digital including texts sent by autodialer. Consent is not a condition of purchase. Msg & data rates may apply. Msg frequency varies. Unsubscribe at any time by replying STOP or clicking the unsubscribe link (where available). <a href=\"www.privacypolicy.com\">Privacy Policy</a> & <a href=\"www.tearmsandservices.com\">Terms</a>.</p>"
}
}
}
]
},
{
"blocks": [
{
"type": "button",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null,
"width": "fill",
"height": 60,
"hover_background_color": null,
"hover_text_color": null,
"border_styles": {
"radius": 2,
"color": null,
"style": null,
"thickness": null
},
"text_styles": {
"font_family": "'Poppins-Klaviyo-Hosted', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 18,
"font_weight": 700,
"text_color": "#000000",
"character_spacing": 0
},
"color": "rgba(0,0,0,1)"
},
"properties": {
"display_device": [
"mobile"
],
"label": "Subscribe via SMS",
"additional_fields": [
{
"name": "$source",
"value": "UC| WelcomeEmail"
}
]
},
"action": {
"submit": true,
"type": "subscribe_via_sms",
"properties": {
"opt_in_keyword": "JOIN",
"opt_in_message": "Send this text to subscribe to recurring automated personalized marketing alerts (e.g. special promotions, cart reminders) from Klaviyo Library",
"sending_number": "+18662592836"
}
}
}
]
},
{
"blocks": [
{
"type": "phone_number",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop"
],
"label": null,
"show_label": false,
"placeholder": "Phone Number",
"required": false,
"error_messages": null,
"property_name": "$phone_number",
"sms_consent_type": [
"promotional",
"transactional"
]
}
},
{
"type": "button",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null,
"width": "fit",
"height": 50,
"hover_background_color": null,
"hover_text_color": null,
"border_styles": {
"radius": 6,
"color": "#211D1C",
"style": null,
"thickness": 2
},
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 20,
"font_weight": 700,
"text_color": "#000000",
"character_spacing": 0
},
"color": "#211D1C"
},
"properties": {
"display_device": [
"desktop"
],
"label": "Send",
"additional_fields": [
{
"name": "$source",
"value": "UC| WelcomeEmail"
}
]
},
"action": {
"submit": true,
"type": "next_step",
"properties": {
"list_id": "RMYivz"
}
}
}
]
},
{
"blocks": [
{
"type": "promotional_sms_checkbox",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null,
"horizontal_alignment": "left"
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"label": "",
"show_label": false,
"error_messages": null,
"required": false,
"property_name": "opt_in_promotional_sms",
"checkbox_text": "Check this box to also receive promotional marketing texts (Exclusive text messaging-only deals, offers, and coupons).",
"placeholder": null
}
}
]
}
],
"styles": null
},
{
"rows": [],
"styles": {
"background_image": {
"styles": {
"horizontal_alignment": "center",
"width": 823,
"position": "custom",
"vertical_alignment": "top",
"custom_width": 510
},
"properties": {
"id": 233891938
}
},
"background_color": null
}
}
],
"name": "SMS",
"steps": null
},
{
"columns": [
{
"rows": [
{
"blocks": [
{
"type": "image",
"styles": {
"horizontal_alignment": "center",
"width": null,
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"image": {
"id": 65984952
},
"additional_fields": null
},
"action": null
}
]
},
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"><span class=\"ql-font-poppins\" style=\"font-size: 28px; color: rgb(55, 63, 71); font-family: Poppins, Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: bold; font-style: normal;\">Thanks for signing up!</span></p>"
}
}
]
},
- Author
- Problem Solver I
- November 19, 2025
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"><span class=\"ql-font-poppins\" style=\"color: rgb(51, 51, 51); font-size: 18px; font-family: Poppins, Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400; font-style: normal;\">Check your mobile device and inbox to confirm your subscription.</span></p>"
}
}
]
},
{
"blocks": [
{
"type": "button",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null,
"width": "fill",
"height": 56,
"hover_background_color": null,
"hover_text_color": null,
"border_styles": {
"radius": 2,
"color": null,
"style": null,
"thickness": null
},
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 20,
"font_weight": 400,
"text_color": "#000000",
"character_spacing": 0
},
"color": "#211D1C"
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"label": "Go to inbox",
"additional_fields": [
{
"name": "$source",
"value": "UC| WelcomeEmail"
}
]
},
"action": {
"submit": true,
"type": "go_to_inbox",
"properties": null
}
}
]
}
],
"styles": null
},
{
"rows": [],
"styles": {
"background_image": {
"styles": {
"horizontal_alignment": "left",
"width": 342,
"position": "custom",
"vertical_alignment": "center",
"custom_width": 500
},
"properties": {
"id": 233895303
}
},
"background_color": null
}
}
],
"name": null,
"steps": null
}
],
"triggers": [
{
"type": "after_close_or_submit_timeout",
"properties": {
"timeout_days": 5
}
}
],
"teasers": [
{
"content": "<p style=\"text-align: center; font-size: 14px; font-family: Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: 400;\"><span style=\"font-size: 18px; color: rgb(0, 0, 0); font-family: Poppins, Arial, 'Helvetica Neue', Helvetica, sans-serif; font-weight: bold; font-style: normal;\">Subscribe Us!</span></p>",
"display_order": "before_and_after",
"teaser_type": "rectangle",
"location": "bottom_left",
"size": "medium",
"custom_size": null,
"styles": {
"background_color": "rgba(212,184,134)",
"drop_shadow": {
"enabled": true,
"blur": 30,
"color": "rgba(0,0,0,0.15)"
},
"corner_radius": 4,
"background_image": null,
"close_button": {
"background_color": "#000000",
"outline_color": "#FFFFFF",
"color": "#FFFFFF",
"stroke": 2,
"size": 20,
"margin": {
"left": 16,
"right": 16,
"top": 16,
"bottom": 16
}
},
"margin": {
"left": 20,
"right": 0,
"top": 0,
"bottom": 0
}
},
"close_button": false,
"device_type": "both"
}
],
"dynamic_button": null,
"name": "Default Flyout",
"styles": {
"wrap_content": false,
"border_styles": {
"radius": 4,
"color": "#000000",
"style": null,
"thickness": 0
},
"close_button": {
"background_color": "rgba(255,255,255,1)",
"outline_color": "rgba(255,255,255,0)",
"color": "#373F47",
"stroke": 1,
"size": 35,
"margin": {
"left": 8,
"right": 8,
"top": 8,
"bottom": 8
}
},
"margin": {
"left": 20,
"right": 20,
"top": 20,
"bottom": 20
},
"padding": {
"left": 24,
"right": 24,
"top": 0,
"bottom": 0
},
"minimum_height": 540,
"width": "custom",
"custom_width": 800,
"background_image": null,
"background_color": "rgba(212,184,134)",
"input_styles": {
"text_styles": {
"font_family": "'Poppins', Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 16,
"font_weight": 400,
"text_color": "#000000",
"character_spacing": 0
},
"label_color": "#000000",
"text_color": "#000000",
"placeholder_color": "#767676",
"background_color": "#FFFFFF",
"border_color": "#606A72",
"border_focus_color": "#000000",
"focus_outline_color": "#1C65AD",
"corner_radius": 4,
"field_height": 50
},
"drop_shadow": {
"enabled": true,
"blur": 30,
"color": "rgba(0,0,0,0.15)"
},
"overlay_color": "rgba(20,20,20,0.6)",
"rich_text_styles": {
"body": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 16,
"font_weight": 400,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"link": {
"color": "#0066cc",
"decoration": "underline"
},
"h1": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 48,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h2": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 36,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h3": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 28,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h4": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 20,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h5": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 13,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
},
"h6": {
"font_family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
"font_size": 11,
"font_weight": 700,
"text_color": "#000000",
"line_spacing": 1.0,
"character_spacing": 0,
"alignment": "left",
"margin": {
"left": 0,
"right": 0,
"top": 0,
"bottom": 0
}
}
},
"mobile_overlay": {
"color": "rgba(20, 20, 20, 0.5)",
"enabled": false
},
"banner_styles": null
},
"properties": {
"side_image_settings": {
"size": "medium",
"alignment": "right",
"device_type": [
"desktop",
"mobile"
]
},
"click_outside_to_close": [
"mobile"
],
"rule_based_trigger_evaluation": "any",
"record_utm_params_on_submit": false,
"show_close_button": true
},
"type": "popup",
"location": null,
"status": "draft",
"ab_test": false,
"specialties": []
}
]
}
}
}
}
- Expert Problem Solver I
- November 19, 2025
Hey
Form versions represent a “version” of the form. There could be multiple if there is an A/B test, or if you previously published the form and then created a new version.
In this case, it looks like the form versions indicate that this is for an A/B test (ab_test true on the version items but not on the top-level form). Given that there doesn’t appear to be a way to configure an A/B test on this endpoint properly I would think that this setup isn’t currently supported. cc
I would try calling the API again with just one item in the “versions” array without ab_test: true and see if that resolves the 500 here.
Cadence / Book a demo
- Community Manager
- November 21, 2025
Hi
I spoke with our engineers, and it seems likely that this is a bug. We have it on our radar to fix. In the meantime, they provided a potential workaround. Can you try passing an empty array into
additional_fieldsThat may solve the issue for now. Let me know if this works.
- Author
- Problem Solver I
- November 21, 2025
additional_fields, but I'm still receiving the same error.
- Author
- Problem Solver I
- November 21, 2025
I also tried the example provided by Klaviyo, but I'm still seeing the same error.
https://developers.klaviyo.com/en/reference/forms_api_overview
{
"data": {
"type": "form",
"attributes": {
"definition": {
"versions": [
{
"steps": [
{
"columns": [
{
"rows": [
{
"blocks": [
{
"type": "html_text",
"properties": {
"content": "<div>Sign up for our newsletter</div>"
}
}
]
},
{
"blocks": [
{
"type": "email",
"properties": {
"label": "Email",
"placeholder": "Enter your email address",
"required": true
}
}
]
},
{
"blocks": [
{
"type": "button",
"properties": {
"label": "Email"
},
"action": {
"submit": true,
"type": "next_step",
"properties": {
"list_id": "RMYivz"
}
}
}
]
}
]
}
],
"name": "email sign-up"
},
{
"columns": [
{
"rows": [
{
"blocks": [
{
"type": "html_text",
"properties": {
"content": "<div>Thank you for subscribing!</div>"
}
}
]
}
]
}
],
"name": "success step"
}
],
"name": "test",
"type": "popup",
"status": "draft"
}
]
},
"status": "draft",
"ab_test": false,
"name": "My first API form"
}
}
}
- Community Manager
- November 24, 2025
Thanks for trying that, Jaydeep. If you’re still receiving the same error, then the next steps would be to wait for our team to fix this bug. Apologies for the inconvenience here. We’re working to get this solved, and I’ll update you once we’ve done this!
Log in to the Community
Use your Klaviyo credentials
Log in with Klaviyo
Use your Klaviyo credentials
Log in with KlaviyoEnter your E-mail address. We'll send you an e-mail with instructions to reset your password.
Scanning file for viruses.
Sorry, we're still checking this file's contents to make sure it's safe to download. Please try again in a few minutes.
OKThis file cannot be downloaded
Sorry, our virus scanner detected that this file isn't safe to download.
OKLinks & Resources
Platforms
Useful Things
-
Terms and Privacy |
© 2024 Klaviyo All rights reserved. Klaviyo and the Klaviyo logo are trademarks or registered trademarks of Klaviyo, Inc. or its affiliates.

