Create Form | Gorilla Dash

curl -X POST https://api.gorilladash.com/api/v1/website-content/forms \
     -H "GorillaDash-Api-Key: {{API_KEY}}" \
     -H "GorillaDash-Api-Secret: {{GD_RESTFUL_SECRET}}" \
     -H "Content-Type: application/json" \
     -d '{
  "slug": "nfc26-sponsor-exhibition-interest",
  "name": "NFC26 Sponsor & Exhibition Interest",
  "status": "Active",
  "notify_emails": [
    "events@example.org"
  ],
  "fields": [
    {
      "key": "first_name",
      "label": "First name",
      "type": "short-text",
      "required": true,
      "maps_to": "first_name"
    },
    {
      "key": "email",
      "label": "Email",
      "type": "email-input",
      "required": true,
      "maps_to": "email"
    },
    {
      "key": "interest",
      "label": "I'\''m interested in",
      "type": "select-list",
      "required": true,
      "maps_to": "string",
      "options": [
        {
          "label": "Sponsorship",
          "value": "Sponsorship"
        },
        {
          "label": "Exhibition",
          "value": "Exhibition"
        }
      ]
    }
  ]
}'

{
  "success": true,
  "status": 201,
  "data": {
    "id": 912,
    "slug": "nfc26-sponsor-exhibition-interest",
    "name": "NFC26 Sponsor & Exhibition Interest",
    "status": "Active",
    "notify_emails": [
      "events@example.org"
    ],
    "notify_tribe": false,
    "create_person": true,
    "fields": [
      {
        "key": "first_name",
        "label": "First name",
        "type": "short-text",
        "required": true,
        "maps_to": "first_name"
      },
      {
        "key": "email",
        "label": "Email",
        "type": "email-input",
        "required": true,
        "maps_to": "email"
      },
      {
        "key": "interest",
        "label": "I'm interested in",
        "type": "select-list",
        "required": true,
        "maps_to": "string",
        "options": [
          {
            "label": "Sponsorship",
            "value": "Sponsorship"
          },
          {
            "label": "Exhibition",
            "value": "Exhibition"
          }
        ]
      }
    ],
    "created_at": "2026-10-07T01:20:00+00:00",
    "updated_at": "2026-10-07T01:20:00+00:00"
  }
}

Creates a form. Needs a key with Website Content: Read and Write (website-content:write).

Field	Type	Rules
`name`	string	Required, max 180.
`slug`	string	Required on upsert, optional on create (generated from the name). Max 110, lowercase letters, digits and single dashes. It is part of the form’s public URL. A slug any form ever used, including a deleted one, returns 422 on create.
`status`	string	`Draft` (the default), `Active` or `Paused`. Only an `Active` form accepts submissions.
`heading`	string\|null	Max 255.
`message`, `thankyou`	string\|null	Max 2000.
`submit_label`	string\|null	Max 60.
`redirect_url`	string\|null	A URL to send the visitor to after submitting.
`notify_emails`	string[]\|null	Up to 20 addresses told about each submission.
`notify_tribe`	boolean	Default false.
`create_person`	boolean	Default true: a submission creates or updates a contact.
`fields`	array	Required on create and upsert, up to 100.
`fields.*.key`	string	Required, max 60, letters, digits, `_` and `-`. Unique within the form.
`fields.*.label`	string	Required, max 255.
`fields.*.type`	string	Required: `short-text`, `long-text`, `number-text`, `switch-input`, `select-list`, `multi-select`, `rating`, `nps`, `date-input`, `email-input`, `phone-input` or `file-upload`.
`fields.*.help`	string\|null	Max 500.
`fields.*.placeholder`	string\|null	Max 255.
`fields.*.required`	boolean
`fields.*.options`	array	For `select-list` and `multi-select`: up to 200 `{label, value}` pairs.
`fields.*.max`	integer	2–10, the top of a `rating` scale.
`fields.*.max_files`	integer	1–10, for `file-upload`.
`fields.*.maps_to`	string\|null	`first_name`, `last_name`, `email` or `phone`: the contact detail this field fills in.

If a form with the same slug already exists, this returns 422. Use Upsert Form when you do not know whether it exists.

Request

This endpoint expects an object.

slugstringRequired

namestringRequired

statusstringRequired

notify_emailslist of stringsRequired

fieldslist of objectsRequired

Response

Created

successboolean

statusinteger

dataobject

Errors

403

Forbidden Error

Headers

Request

Response

Errors