Forms

The forms object is where you declare form resources you need for your site. You can set the following properties on forms:

Config Example

{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "fields": {
        "email": { "type": "email", "required": true },
        "message": { "type": "text", "required": true }
      },
      "actions": [
        { "type": "email", "to": "john@example.com" }
      ],
      "allowExtraFields": false
    }
  }
}

Actions

An Array of actions to perform after the form is submitted. We have a few built-in actions:

We also have integrations with other apps:

Send a notification email

Email a simple plain-text notification to somebody when the form is submitted.

Config Example

{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "type": "email",
          "to": "john@example.com"
        }
      ]
    }
  }
}

Send a webhook

Send an HTTP POST to a given URL with a JSON body.

Config Example

{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "type": "webhook",
          "url": "http://example.com/hook"
        }
      ]
    }
  }
}

Request Body

The body of the webhook contains the following properties in JSON format:

Here's an example:

{
  "type": "form.submitted",
  "form_id": "6f711462a450",
  "submission_id": "ef3f189d-c83d-4210-8320-03b4ee27394d",
  "occurred_at": "2020-01-01T00:00:00Z",
  "data": {
    "first_name": "Bob",
    "last_name": "Loblaw"
  }
}

Fields

An Object containing optional field metadata.

Note: By default, StaticKit will accept any fields you pass in from the client-side. However, defining your fields here allows you to add validations (such as marking a field as required) and give them human-friendly names.

Field objects can contain the following properties:

Config Example

{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "fields": {
        "email": {
          "type": "email",
          "prettyName": "Email address",
          "required": true
        }
      }
    }
  }
}