Skip to main content
Question

Issue while creating form via API

  • November 18, 2025
  • 10 replies
  • 67 views

Forum|alt.badge.img+6

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

10 replies

cadence
Expert Problem Solver I
Forum|alt.badge.img+7
  • Expert Problem Solver I
  • November 18, 2025

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


Forum|alt.badge.img+6
  • Author
  • Problem Solver I
  • November 18, 2025

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


cadence
Expert Problem Solver I
Forum|alt.badge.img+7
  • Expert Problem Solver I
  • November 18, 2025

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


Forum|alt.badge.img+6
  • 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;\">&nbsp;</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 &amp; 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> &amp; <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;\">&nbsp;</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 &amp; 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> &amp; <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>"
  }
 }
]
  },


Forum|alt.badge.img+6
  • 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": []
  }
 ]
}
  }
 }
}


cadence
Expert Problem Solver I
Forum|alt.badge.img+7
  • Expert Problem Solver I
  • November 19, 2025

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


Byrne C
Community Manager
Forum|alt.badge.img+27
  • Community Manager
  • November 21, 2025

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.


Forum|alt.badge.img+6
  • Author
  • Problem Solver I
  • November 21, 2025

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


Forum|alt.badge.img+6
  • 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"
    }
  }
}


Byrne C
Community Manager
Forum|alt.badge.img+27
  • Community Manager
  • November 24, 2025

@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!