Carrd

Carrd's contact and signup forms send submissions to Carrd's own destinations. Custom forms on Pro Plus can send to any URL, which is all Ikiform needs, and Pro Standard can embed your own HTML.

Custom form with Send to URL

1. Create the form

   Click Add Element > Form and set Type to Custom, then Send to URL.

2. Set the URL, method and format

   https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx

   Setting	Value	Why
   Method	AJAX	Keeps visitors on the page. Carrd reads any 2xx as success, and Ikiform answers 201 when it stores the submission.
   Format	Default	Sends a standard form post. JSON works too.
   Headers	None	Ikiform needs no headers from a browser.

   With POST instead of AJAX, the browser leaves your Carrd site for Ikiform's thank-you page or your Redirect after submit URL, and Carrd's On Success setting doesn't apply. Don't choose XML: Ikiform refuses it with 415 unsupported_media_type.

3. Set field IDs

   Each field's Submitted ID, or its ID when that's empty, becomes the field name in Ikiform. Carrd generates IDs from labels, so set them yourself: email, name, message. With Format set to JSON, a Submitted ID such as fields.firstname is sent as a nested object, which Ikiform stores as-is.

   • Don't add a File field. Ikiform doesn't accept files yet and refuses the post with 422 files_not_supported.
   • Collect UTM parameters adds utm_source, utm_medium, utm_campaign, utm_term and utm_content. If you define fields in Ikiform, add these too, or the post fails with an Unknown field error.
   • A Hidden field always has its preset value, so it can't act as a honeypot. Spam scoring still runs on every post.

4. Choose On Success and On Failure

   Pick what Carrd shows after the request. On Failure covers every Ikiform error, such as 422 validation_failed or 429 rate_limited; Carrd doesn't display Ikiform's message, so keep your failure text general.

Embed element on Pro Standard

Click Add Element > Embed, set Type to Code and Style to Inline, and paste a form. Embeds don't render in the builder, so publish to see it.

<form action="https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx" method="post" target="_top">
  <input name="email" type="email" placeholder="Email" autocomplete="email" required>
  <input name="_gotcha" type="text" tabindex="-1" autocomplete="off" hidden>
  <button type="submit">Join the waitlist</button>
</form>

This posts as a normal form, so the human check works if you turn it on. Style it with a <style> block, or start from the fuller site builder embed.

Allowed domains

With either option, the browser sends the post from your Carrd page, so allowed domains work as usual.

• Never add carrd.co or crd.co on its own. Every site on that host would match, including other people's.

Test checklist

1. Publish the site. Forms and embeds only work on the published site.
2. Submit the form and confirm Carrd shows your On Success message, or that the embed lands on the thank-you page.
3. Open the submission in Ikiform and check the field names are the IDs you set, not generated ones.
4. Submit with an email that isn't valid while the form has fields defined, and confirm Carrd shows On Failure.

Troubleshooting

Related

• Site buildersThe embed that works in any builder.
• HTML formsRedirects, reserved fields and the honeypot.
• ErrorsEvery error code, with its cause and fix.
• Allowed domainsHow origins are matched, and what a mismatch does.