Getting Started

Formcake is an easy way to configure a form without spinning up a whole backend. It works with traditional server-side rendered sites as well as SPAs / JS-based form solutions.

Copy our Endpoint

To use formcake, all your need is the form's submission url (which you can find in your form dashboard under the Install tab).

https://formcake.com/api/form/577cdc9f-c058-41a7-9a02-330a8ca40684/submission

Add it to your Form

Then just paste that endpoint into your <form> tag's action attribute. We're assuming this example is using a traditional form over a JS-based submission.

<form method="POST" action="https://formcake.com/api/form/577cdc9f-c058-41a7-9a02-330a8ca40684/submission">
    <input type="text" name="name" value="example"/>
    <input type="email" name="email" value="example@formcake.com"/>
    <button type="submit">Submit</button>
</form>

Configure your Response

Formcake can respond to submissions in three ways.

• redirect the user to a page you control
• redirect the user to our default "success" page (if you don't have a redirect selected)
• return a JSON response.

You can select between these redirect options in the Settings tab of your form.

Config

Once you create a form you can change it's behavior through the forms dashboard.

Redirect vs JSON Response

Redirect: If your submission includes the form header application/x-www-form-urlencoded your site will perform a redirect. If you've configured a redirect in your form's Settings tab (using a full URL), it will use that redirect. If you haven't specific a redirect, it will use our default success page.

JSON: If your submission doesn't include the form header application/x-www-form-urlencoded your submission will return a JSON response.

Example JSON Response

{
    createdAt: "2019-11-07T17:02:38.437Z",
    data: {
        email: "example@formcake.com",
        name: "example",
    },
    domain: "formcake.com",
    formId: "dc99a91f90-jd98dd-41ba-8263-8f897hsd9s7nds97d",
    id: 33,
    updatedAt: "2019-11-07T17:02:38.437Z",
}

You can see here that the data is populated by creating a key-value pair, where the key is the name of the form input and the value is the input's value.

Domain Whitelisting

To ensure your form doesn't receive spam submissions you can configure multiple domains to whitelist. Formcake will reject any submissions that don't come from these sources. If you don't configure any domains, your form will be considered anyonmous, and anyone will be able to post to it.

Whitelisted domains are added in a form's Settings tab in the form dashboard or during the form creation process.

Actions

When you receive a form submission, you can trigger an action (found in the Actions tab).

Each form can have any number of actions, bounded only by your plan's limitations.

Email Notification

The Email Notification action sends the designated address an email with your form submission data presented in table form.

Required Fields

Field Name	Description
action name	The name you'd like to give your action
form	The UUID of the form you're attaching the action to
email address	The address of the email's recipient
email subject line	The email's subject line

Email Template

The Email Template action sends the designated address an email with the option of formatting your form submission data using a Liquid template.

Required Fields

Field Name	Description
action name	The name you'd like to give your action
form	The UUID of the form you're attaching the action to
email address	The address of the email's recipient
email subject line	The email's subject line
email content	The body of the email you're sending, templated with the values of your form using Liquid

Webhook

The Webhook action sends a POST request to the URL of your choice with your form submission data included within a data object in the body of the HTTP request.

Required Fields

Field Name	Description
action name	The name you'd like to give your action
form	The UUID of the form you're attaching the action to
url	The URL you would like the webhook to POST to
basic auth	Add a HTTP Basic Auth username/password string to your webhook.
headers	Custom headers you'd like to include in your request
key replacements	User key replacements to map your form submission data to new property keys.

Example Webhook Request

{
    url: "https://formcake.com/example",
    domain: "formcake.com",
    formId: "dc99a91f90-jd98dd-41ba-8263-8f897hsd9s7nds97d",
    dtCreated: "2019-12-05T02:28:23.742Z",
    email: "example@formcake.com",
    name: "example",
}

Zapier

Coming Soon

Submissions

Submission Limits

There are no limits to how many submissions an individual form can receive, or to how long or how much data is stored. Check the pricing page for more information on our per-account limits and go to the account page if you'd like to change your plan and those limits.

Note that for free "Sandbox" plans we will immediately drop all submissions over the limit threshold. For "Developer" and above plans we'll work to contact the owner about an upgrade first.

Exporting Submissions

Submissions can be exported as a CSV by going to the Submissions section of your chosen form.