> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.gorilladash.com/gorilla-dash-rest-ful-api/website-content/forms/create-form/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.gorilladash.com/_mcp/server. # Create Form POST https://api.gorilladash.com/api/v1/website-content/forms Content-Type: application/json 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. Reference: https://docs.gorilladash.com/gorilla-dash-rest-ful-api/website-content/forms/create-form ## Request ### Headers - `GorillaDash-Api-Key` (string, optional) — Gorilla Dash API Key - `GorillaDash-Api-Secret` (string, optional) — Gorilla Dash API Secret ### Body (application/json) This endpoint expects an object. - `slug` (string, required) - `name` (string, required) - `status` (string, required) - `notify_emails` (list of string, required) - `fields` (list of ApiV1WebsiteContentFormsPostRequestBodyContentApplicationJsonSchemaFieldsItems, required) ## Response ### 201 Created - `success` (boolean, required) - `status` (integer, required) - `data` (ApiV1WebsiteContentFormsPostResponsesContentApplicationJsonSchemaData, required) ## Errors ### 403 Forbidden Error Forbidden - `message` (string, required) ## Types ### ApiV1WebsiteContentFormsPostRequestBodyContentApplicationJsonSchemaFieldsItems - `key` (string, required) - `label` (string, required) - `type` (string, required) - `required` (boolean, required) - `maps_to` (string, required) ### ApiV1WebsiteContentFormsPostResponsesContentApplicationJsonSchemaData - `id` (integer, required) - `slug` (string, required) - `name` (string, required) - `status` (string, required) - `notify_emails` (list of string, required) - `notify_tribe` (boolean, required) - `create_person` (boolean, required) - `fields` (list of ApiV1WebsiteContentFormsPostResponsesContentApplicationJsonSchemaDataFieldsItems, required) - `created_at` (datetime, required) - `updated_at` (datetime, required) - `heading` (any, optional) - `message` (any, optional) - `submit_label` (any, optional) - `thankyou` (any, optional) - `redirect_url` (any, optional) ### ApiV1WebsiteContentFormsPostResponsesContentApplicationJsonSchemaDataFieldsItems - `key` (string, required) - `label` (string, required) - `type` (string, required) - `required` (boolean, required) - `maps_to` (string, required) ## Examples **Request** ```json { "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" } ] } ] } ``` **Response** ```json { "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" } } ``` **SDK Code** ```python Website Content_Forms_Create Form_example import requests url = "https://api.gorilladash.com/api/v1/website-content/forms" payload = { "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" } ] } ] } headers = { "GorillaDash-Api-Key": "{{API_KEY}}", "GorillaDash-Api-Secret": "{{GD_RESTFUL_SECRET}}", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Website Content_Forms_Create Form_example const url = 'https://api.gorilladash.com/api/v1/website-content/forms'; const options = { method: 'POST', headers: { 'GorillaDash-Api-Key': '{{API_KEY}}', 'GorillaDash-Api-Secret': '{{GD_RESTFUL_SECRET}}', 'Content-Type': 'application/json' }, body: '{"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"}]}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Website Content_Forms_Create Form_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.gorilladash.com/api/v1/website-content/forms" payload := strings.NewReader("{\n \"slug\": \"nfc26-sponsor-exhibition-interest\",\n \"name\": \"NFC26 Sponsor & Exhibition Interest\",\n \"status\": \"Active\",\n \"notify_emails\": [\n \"events@example.org\"\n ],\n \"fields\": [\n {\n \"key\": \"first_name\",\n \"label\": \"First name\",\n \"type\": \"short-text\",\n \"required\": true,\n \"maps_to\": \"first_name\"\n },\n {\n \"key\": \"email\",\n \"label\": \"Email\",\n \"type\": \"email-input\",\n \"required\": true,\n \"maps_to\": \"email\"\n },\n {\n \"key\": \"interest\",\n \"label\": \"I'm interested in\",\n \"type\": \"select-list\",\n \"required\": true,\n \"maps_to\": \"string\",\n \"options\": [\n {\n \"label\": \"Sponsorship\",\n \"value\": \"Sponsorship\"\n },\n {\n \"label\": \"Exhibition\",\n \"value\": \"Exhibition\"\n }\n ]\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("GorillaDash-Api-Key", "{{API_KEY}}") req.Header.Add("GorillaDash-Api-Secret", "{{GD_RESTFUL_SECRET}}") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Website Content_Forms_Create Form_example require 'uri' require 'net/http' url = URI("https://api.gorilladash.com/api/v1/website-content/forms") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["GorillaDash-Api-Key"] = '{{API_KEY}}' request["GorillaDash-Api-Secret"] = '{{GD_RESTFUL_SECRET}}' request["Content-Type"] = 'application/json' request.body = "{\n \"slug\": \"nfc26-sponsor-exhibition-interest\",\n \"name\": \"NFC26 Sponsor & Exhibition Interest\",\n \"status\": \"Active\",\n \"notify_emails\": [\n \"events@example.org\"\n ],\n \"fields\": [\n {\n \"key\": \"first_name\",\n \"label\": \"First name\",\n \"type\": \"short-text\",\n \"required\": true,\n \"maps_to\": \"first_name\"\n },\n {\n \"key\": \"email\",\n \"label\": \"Email\",\n \"type\": \"email-input\",\n \"required\": true,\n \"maps_to\": \"email\"\n },\n {\n \"key\": \"interest\",\n \"label\": \"I'm interested in\",\n \"type\": \"select-list\",\n \"required\": true,\n \"maps_to\": \"string\",\n \"options\": [\n {\n \"label\": \"Sponsorship\",\n \"value\": \"Sponsorship\"\n },\n {\n \"label\": \"Exhibition\",\n \"value\": \"Exhibition\"\n }\n ]\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Website Content_Forms_Create Form_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.gorilladash.com/api/v1/website-content/forms") .header("GorillaDash-Api-Key", "{{API_KEY}}") .header("GorillaDash-Api-Secret", "{{GD_RESTFUL_SECRET}}") .header("Content-Type", "application/json") .body("{\n \"slug\": \"nfc26-sponsor-exhibition-interest\",\n \"name\": \"NFC26 Sponsor & Exhibition Interest\",\n \"status\": \"Active\",\n \"notify_emails\": [\n \"events@example.org\"\n ],\n \"fields\": [\n {\n \"key\": \"first_name\",\n \"label\": \"First name\",\n \"type\": \"short-text\",\n \"required\": true,\n \"maps_to\": \"first_name\"\n },\n {\n \"key\": \"email\",\n \"label\": \"Email\",\n \"type\": \"email-input\",\n \"required\": true,\n \"maps_to\": \"email\"\n },\n {\n \"key\": \"interest\",\n \"label\": \"I'm interested in\",\n \"type\": \"select-list\",\n \"required\": true,\n \"maps_to\": \"string\",\n \"options\": [\n {\n \"label\": \"Sponsorship\",\n \"value\": \"Sponsorship\"\n },\n {\n \"label\": \"Exhibition\",\n \"value\": \"Exhibition\"\n }\n ]\n }\n ]\n}") .asString(); ``` ```php Website Content_Forms_Create Form_example request('POST', 'https://api.gorilladash.com/api/v1/website-content/forms', [ 'body' => '{ "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" } ] } ] }', 'headers' => [ 'Content-Type' => 'application/json', 'GorillaDash-Api-Key' => '{{API_KEY}}', 'GorillaDash-Api-Secret' => '{{GD_RESTFUL_SECRET}}', ], ]); echo $response->getBody(); ``` ```csharp Website Content_Forms_Create Form_example using RestSharp; var client = new RestClient("https://api.gorilladash.com/api/v1/website-content/forms"); var request = new RestRequest(Method.POST); request.AddHeader("GorillaDash-Api-Key", "{{API_KEY}}"); request.AddHeader("GorillaDash-Api-Secret", "{{GD_RESTFUL_SECRET}}"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"slug\": \"nfc26-sponsor-exhibition-interest\",\n \"name\": \"NFC26 Sponsor & Exhibition Interest\",\n \"status\": \"Active\",\n \"notify_emails\": [\n \"events@example.org\"\n ],\n \"fields\": [\n {\n \"key\": \"first_name\",\n \"label\": \"First name\",\n \"type\": \"short-text\",\n \"required\": true,\n \"maps_to\": \"first_name\"\n },\n {\n \"key\": \"email\",\n \"label\": \"Email\",\n \"type\": \"email-input\",\n \"required\": true,\n \"maps_to\": \"email\"\n },\n {\n \"key\": \"interest\",\n \"label\": \"I'm interested in\",\n \"type\": \"select-list\",\n \"required\": true,\n \"maps_to\": \"string\",\n \"options\": [\n {\n \"label\": \"Sponsorship\",\n \"value\": \"Sponsorship\"\n },\n {\n \"label\": \"Exhibition\",\n \"value\": \"Exhibition\"\n }\n ]\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Website Content_Forms_Create Form_example import Foundation let headers = [ "GorillaDash-Api-Key": "{{API_KEY}}", "GorillaDash-Api-Secret": "{{GD_RESTFUL_SECRET}}", "Content-Type": "application/json" ] let parameters = [ "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" ] ] ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.gorilladash.com/api/v1/website-content/forms")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```