Problem Solver I

Solved

Issue while creating form via API

Forum|Forum|9 months ago
November 18, 2025
10 replies
224 views

I am attempting to create the form through the API, but I am encountering the following error:

{

"errors": [

{

"id": "a3afc810-5780-4d31-9d9e-ff0b50ae986c",

"status": 500,

"code": "error",

"title": "A server error occurred.",

"detail": "A server error occurred.",

"source": {

"pointer": "/data/"

}

]

}

API

Best answer by Byrne C

@JaydeepPatel,

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!

Kim from Cadence

Partner

Hey @JaydeepPatel, the 500 indicates an error on Klaviyo’s side. Do you have more details on the payload you were using that hit this error? It’s possible you’re trying to use a feature that isn’t currently supported by the API and it’s not handling it well.

Cadence / Book a demo

Kim — Founder @ Cadence | Helping brands automate recurring campaigns (daily, weekly, monthly) | Happy to connect! | https://cadencecampaigns.com

J

JaydeepPatelAuthor

Problem Solver I

Hey @cadence - I am referring to this url “https://developers.klaviyo.com/en/reference/create_form”.

Thanks! Jaydeep Patel

Kim from Cadence

Partner

Hey @JaydeepPatel, do you mind copy/pasting the exact JSON body you’re sending via the API? There shouldn’t be any sensitive info in the body. The docs examples aren’t realistic, so it’s hard to get a sense of what’s going wrong here. Also, I’d recommend you create a form via the UI first, retrieve it via the GET endpoint and transform the response a bit to get your payload for the Create Form API call.

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.

Cadence / Book a demo

Kim — Founder @ Cadence | Helping brands automate recurring campaigns (daily, weekly, monthly) | Happy to connect! | https://cadencecampaigns.com

J

JaydeepPatelAuthor

Problem Solver I

{
"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": "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."
}
}
]
},
{
"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": "Want SMS-alerts?\n "
}
}
]
},
{
"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": "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>."
}
}
}
]
},
{
"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": "Thanks for signing up!"
}
}
]
},
{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "Check your mobile device and inbox to confirm your subscription."
}
}
]
},
{
"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": "Subscribe Us!",
"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": "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."
}
}
]
},
{
"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": "Want SMS-alerts?\n "
}
}
]
},
{
"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": "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>."
}
}
}
]
},
{
"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": "Thanks for signing up!"
}
}
]
},

Thanks! Jaydeep Patel

J

JaydeepPatelAuthor

Problem Solver I

{
"blocks": [
{
"type": "html_text",
"styles": {
"padding": {
"left": 6,
"right": 6,
"top": 10,
"bottom": 10
},
"background_color": null
},
"properties": {
"display_device": [
"desktop",
"mobile"
],
"content": "Check your mobile device and inbox to confirm your subscription."
}
}
]
},
{
"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": "Subscribe Us!",
"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": []
}
]
}
}
}
}

Thanks! Jaydeep Patel

Kim from Cadence

Partner

Hey @JaydeepPatel, from your json payload it looks like you are including two form versions. I think that’s the likely source of the issue here.

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 @Byrne C to confirm

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

Kim — Founder @ Cadence | Helping brands automate recurring campaigns (daily, weekly, monthly) | Happy to connect! | https://cadencecampaigns.com

Byrne C

Community Manager

Hi @JaydeepPatel and @cadence,

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_fields

That may solve the issue for now. Let me know if this works.

J

JaydeepPatelAuthor

Problem Solver I

@Byrne C - thanks for checking. I tried passing an empty array into additional_fields, but I'm still receiving the same error.

Thanks! Jaydeep Patel

J

JaydeepPatelAuthor

Problem Solver I

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"
}
}
}

Thanks! Jaydeep Patel

Byrne CAnswer

Community Manager

@JaydeepPatel,

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!

Sign up

Use your Klaviyo credentials

Log in to the Community

Use your Klaviyo credentials