> 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/enquiries/create-enquiry/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.gorilladash.com/_mcp/server. # Create Enquiry POST https://api.gorilladash.com/api/v1/enquiries Content-Type: application/json Push a lead into Gorilla Dash. **Required** — `enquiry_form_slug` (the form's **slug**, not its name — list them with `GET /enquiry-forms`), `first_name`, `email`. Everything else is optional. **`tracking_data`** (attribution parameters — how the lead gets a source other than "Direct") * Validated per row since August 2026: `parameter` is a required string; `value`, `path` and `session_at` are nullable. * **`session_at` is optional.** Omit it and it defaults to the time of receipt. Previously a row without it aborted the insert and the whole lead was lost with a 500. * Numeric and boolean scalars (a Meta `ad_id`, for example) are coerced to strings before validation, so existing senders do not newly 422. Arrays and objects still 422. * Control characters (NUL in particular) are stripped from the parameter name, value and path. **`fields`** — names are matched against the enquiry form's own fields. Anything not on the form is silently dropped, so check the form definition with `GET /enquiry-forms/{slug}` first. **404 has two unrelated causes** — the `enquiry_form_slug` does not exist on this organisation, *or* the organisation has no default website. Retries are safe: an identical payload sent twice is de-duplicated by hash and returns the same enquiry. Success is HTTP **201**. Reference: https://docs.gorilladash.com/gorilla-dash-rest-ful-api/enquiries/create-enquiry ## Request ### Headers - `GorillaDash-Api-Key` (string, optional) — Gorilla Dash API Key - `GorillaDash-Api-Secret` (string, optional) — Gorilla Dash API Secret - `X-Requested-With` (string, optional) - `standard-error-handle` (string, optional) ### Body (application/json) This endpoint expects an object. - `enquiry_form_slug` (string, required) - `first_name` (string, required) - `last_name` (string, required) - `email` (string, required) - `mobile` (string, required) - `tribe_slug` (string, required) - `tribe_name` (string, required) - `address_1` (string, required) - `locality` (string, required) - `state` (string, required) - `postal_code` (string, required) - `country` (string, required) - `latitude` (double, required) - `longitude` (double, required) - `ip` (string, required) - `notify` (boolean, required) - `fields` (list of ApiV1EnquiriesPostRequestBodyContentApplicationJsonSchemaFieldsItems, required) - `tracking_data` (list of ApiV1EnquiriesPostRequestBodyContentApplicationJsonSchemaTrackingDataItems, required) - `business_name` (any, optional) - `address_2` (any, optional) - `client_site_visitor_id` (any, optional) ## Response ### 201 Created - `status` (integer, required) - `success` (boolean, required) - `data` (ApiV1EnquiriesPostResponsesContentApplicationJsonSchemaData, required) ## Errors ### 404 Not Found Error Not Found - `status` (integer, required) - `success` (boolean, required) - `error` (ApiV1EnquiriesPostResponsesContentApplicationJsonSchemaError, required) ## Types ### ApiV1EnquiriesPostRequestBodyContentApplicationJsonSchemaFieldsItems - `name` (string, required) - `value` (string, required) ### ApiV1EnquiriesPostRequestBodyContentApplicationJsonSchemaTrackingDataItems - `parameter` (string, required) - `value` (string, required) - `path` (string, required) - `session_at` (datetime, required) ### ApiV1EnquiriesPostResponsesContentApplicationJsonSchemaData - `id` (integer, required) - `message` (string, required) ### ApiV1EnquiriesPostResponsesContentApplicationJsonSchemaError - `code` (string, required) - `message` (any, optional) ## Examples **Request** ```json { "enquiry_form_slug": "meta-lead-gen", "first_name": "Casper", "last_name": "Lai", "email": "casper@gorilladash.com", "mobile": "+61412345678", "tribe_slug": "fl-demo", "tribe_name": "Demo", "address_1": "2121 Vista Parkway", "locality": "West Palm Beach", "state": "FL", "postal_code": "33411", "country": "US", "latitude": 26.7162238, "longitude": -80.1504443, "ip": "203.0.113.10", "notify": true, "fields": [ { "name": "Message", "value": "Test" } ], "tracking_data": [ { "parameter": "utm_source", "value": "facebook", "path": "/contact-us", "session_at": "2026-08-29T04:12:00Z" }, { "parameter": "ad_id", "value": "120210000000000000", "path": "string", "session_at": "2024-01-15T09:30:00Z" } ] } ``` **Response** ```json { "status": 201, "success": true, "data": { "id": 123456, "message": "Enquiry created successfully." } } ``` **SDK Code** ```python Enquiries_Create Enquiry_example import requests url = "https://api.gorilladash.com/api/v1/enquiries" payload = { "enquiry_form_slug": "meta-lead-gen", "first_name": "Casper", "last_name": "Lai", "email": "casper@gorilladash.com", "mobile": "+61412345678", "tribe_slug": "fl-demo", "tribe_name": "Demo", "address_1": "2121 Vista Parkway", "locality": "West Palm Beach", "state": "FL", "postal_code": "33411", "country": "US", "latitude": 26.7162238, "longitude": -80.1504443, "ip": "203.0.113.10", "notify": True, "fields": [ { "name": "Message", "value": "Test" } ], "tracking_data": [ { "parameter": "utm_source", "value": "facebook", "path": "/contact-us", "session_at": "2026-08-29T04:12:00Z" }, { "parameter": "ad_id", "value": "120210000000000000", "path": "string", "session_at": "2024-01-15T09:30:00Z" } ] } headers = { "GorillaDash-Api-Key": "{{API_KEY}}", "GorillaDash-Api-Secret": "{{GD_RESTFUL_SECRET}}", "X-Requested-With": "XMLHttpRequest", "standard-error-handle": "1", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Enquiries_Create Enquiry_example const url = 'https://api.gorilladash.com/api/v1/enquiries'; const options = { method: 'POST', headers: { 'GorillaDash-Api-Key': '{{API_KEY}}', 'GorillaDash-Api-Secret': '{{GD_RESTFUL_SECRET}}', 'X-Requested-With': 'XMLHttpRequest', 'standard-error-handle': '1', 'Content-Type': 'application/json' }, body: '{"enquiry_form_slug":"meta-lead-gen","first_name":"Casper","last_name":"Lai","email":"casper@gorilladash.com","mobile":"+61412345678","tribe_slug":"fl-demo","tribe_name":"Demo","address_1":"2121 Vista Parkway","locality":"West Palm Beach","state":"FL","postal_code":"33411","country":"US","latitude":26.7162238,"longitude":-80.1504443,"ip":"203.0.113.10","notify":true,"fields":[{"name":"Message","value":"Test"}],"tracking_data":[{"parameter":"utm_source","value":"facebook","path":"/contact-us","session_at":"2026-08-29T04:12:00Z"},{"parameter":"ad_id","value":"120210000000000000","path":"string","session_at":"2024-01-15T09:30:00Z"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Enquiries_Create Enquiry_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.gorilladash.com/api/v1/enquiries" payload := strings.NewReader("{\n \"enquiry_form_slug\": \"meta-lead-gen\",\n \"first_name\": \"Casper\",\n \"last_name\": \"Lai\",\n \"email\": \"casper@gorilladash.com\",\n \"mobile\": \"+61412345678\",\n \"tribe_slug\": \"fl-demo\",\n \"tribe_name\": \"Demo\",\n \"address_1\": \"2121 Vista Parkway\",\n \"locality\": \"West Palm Beach\",\n \"state\": \"FL\",\n \"postal_code\": \"33411\",\n \"country\": \"US\",\n \"latitude\": 26.7162238,\n \"longitude\": -80.1504443,\n \"ip\": \"203.0.113.10\",\n \"notify\": true,\n \"fields\": [\n {\n \"name\": \"Message\",\n \"value\": \"Test\"\n }\n ],\n \"tracking_data\": [\n {\n \"parameter\": \"utm_source\",\n \"value\": \"facebook\",\n \"path\": \"/contact-us\",\n \"session_at\": \"2026-08-29T04:12:00Z\"\n },\n {\n \"parameter\": \"ad_id\",\n \"value\": \"120210000000000000\",\n \"path\": \"string\",\n \"session_at\": \"2024-01-15T09:30:00Z\"\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("X-Requested-With", "XMLHttpRequest") req.Header.Add("standard-error-handle", "1") 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 Enquiries_Create Enquiry_example require 'uri' require 'net/http' url = URI("https://api.gorilladash.com/api/v1/enquiries") 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["X-Requested-With"] = 'XMLHttpRequest' request["standard-error-handle"] = '1' request["Content-Type"] = 'application/json' request.body = "{\n \"enquiry_form_slug\": \"meta-lead-gen\",\n \"first_name\": \"Casper\",\n \"last_name\": \"Lai\",\n \"email\": \"casper@gorilladash.com\",\n \"mobile\": \"+61412345678\",\n \"tribe_slug\": \"fl-demo\",\n \"tribe_name\": \"Demo\",\n \"address_1\": \"2121 Vista Parkway\",\n \"locality\": \"West Palm Beach\",\n \"state\": \"FL\",\n \"postal_code\": \"33411\",\n \"country\": \"US\",\n \"latitude\": 26.7162238,\n \"longitude\": -80.1504443,\n \"ip\": \"203.0.113.10\",\n \"notify\": true,\n \"fields\": [\n {\n \"name\": \"Message\",\n \"value\": \"Test\"\n }\n ],\n \"tracking_data\": [\n {\n \"parameter\": \"utm_source\",\n \"value\": \"facebook\",\n \"path\": \"/contact-us\",\n \"session_at\": \"2026-08-29T04:12:00Z\"\n },\n {\n \"parameter\": \"ad_id\",\n \"value\": \"120210000000000000\",\n \"path\": \"string\",\n \"session_at\": \"2024-01-15T09:30:00Z\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java Enquiries_Create Enquiry_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.gorilladash.com/api/v1/enquiries") .header("GorillaDash-Api-Key", "{{API_KEY}}") .header("GorillaDash-Api-Secret", "{{GD_RESTFUL_SECRET}}") .header("X-Requested-With", "XMLHttpRequest") .header("standard-error-handle", "1") .header("Content-Type", "application/json") .body("{\n \"enquiry_form_slug\": \"meta-lead-gen\",\n \"first_name\": \"Casper\",\n \"last_name\": \"Lai\",\n \"email\": \"casper@gorilladash.com\",\n \"mobile\": \"+61412345678\",\n \"tribe_slug\": \"fl-demo\",\n \"tribe_name\": \"Demo\",\n \"address_1\": \"2121 Vista Parkway\",\n \"locality\": \"West Palm Beach\",\n \"state\": \"FL\",\n \"postal_code\": \"33411\",\n \"country\": \"US\",\n \"latitude\": 26.7162238,\n \"longitude\": -80.1504443,\n \"ip\": \"203.0.113.10\",\n \"notify\": true,\n \"fields\": [\n {\n \"name\": \"Message\",\n \"value\": \"Test\"\n }\n ],\n \"tracking_data\": [\n {\n \"parameter\": \"utm_source\",\n \"value\": \"facebook\",\n \"path\": \"/contact-us\",\n \"session_at\": \"2026-08-29T04:12:00Z\"\n },\n {\n \"parameter\": \"ad_id\",\n \"value\": \"120210000000000000\",\n \"path\": \"string\",\n \"session_at\": \"2024-01-15T09:30:00Z\"\n }\n ]\n}") .asString(); ``` ```php Enquiries_Create Enquiry_example request('POST', 'https://api.gorilladash.com/api/v1/enquiries', [ 'body' => '{ "enquiry_form_slug": "meta-lead-gen", "first_name": "Casper", "last_name": "Lai", "email": "casper@gorilladash.com", "mobile": "+61412345678", "tribe_slug": "fl-demo", "tribe_name": "Demo", "address_1": "2121 Vista Parkway", "locality": "West Palm Beach", "state": "FL", "postal_code": "33411", "country": "US", "latitude": 26.7162238, "longitude": -80.1504443, "ip": "203.0.113.10", "notify": true, "fields": [ { "name": "Message", "value": "Test" } ], "tracking_data": [ { "parameter": "utm_source", "value": "facebook", "path": "/contact-us", "session_at": "2026-08-29T04:12:00Z" }, { "parameter": "ad_id", "value": "120210000000000000", "path": "string", "session_at": "2024-01-15T09:30:00Z" } ] }', 'headers' => [ 'Content-Type' => 'application/json', 'GorillaDash-Api-Key' => '{{API_KEY}}', 'GorillaDash-Api-Secret' => '{{GD_RESTFUL_SECRET}}', 'X-Requested-With' => 'XMLHttpRequest', 'standard-error-handle' => '1', ], ]); echo $response->getBody(); ``` ```csharp Enquiries_Create Enquiry_example using RestSharp; var client = new RestClient("https://api.gorilladash.com/api/v1/enquiries"); var request = new RestRequest(Method.POST); request.AddHeader("GorillaDash-Api-Key", "{{API_KEY}}"); request.AddHeader("GorillaDash-Api-Secret", "{{GD_RESTFUL_SECRET}}"); request.AddHeader("X-Requested-With", "XMLHttpRequest"); request.AddHeader("standard-error-handle", "1"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"enquiry_form_slug\": \"meta-lead-gen\",\n \"first_name\": \"Casper\",\n \"last_name\": \"Lai\",\n \"email\": \"casper@gorilladash.com\",\n \"mobile\": \"+61412345678\",\n \"tribe_slug\": \"fl-demo\",\n \"tribe_name\": \"Demo\",\n \"address_1\": \"2121 Vista Parkway\",\n \"locality\": \"West Palm Beach\",\n \"state\": \"FL\",\n \"postal_code\": \"33411\",\n \"country\": \"US\",\n \"latitude\": 26.7162238,\n \"longitude\": -80.1504443,\n \"ip\": \"203.0.113.10\",\n \"notify\": true,\n \"fields\": [\n {\n \"name\": \"Message\",\n \"value\": \"Test\"\n }\n ],\n \"tracking_data\": [\n {\n \"parameter\": \"utm_source\",\n \"value\": \"facebook\",\n \"path\": \"/contact-us\",\n \"session_at\": \"2026-08-29T04:12:00Z\"\n },\n {\n \"parameter\": \"ad_id\",\n \"value\": \"120210000000000000\",\n \"path\": \"string\",\n \"session_at\": \"2024-01-15T09:30:00Z\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Enquiries_Create Enquiry_example import Foundation let headers = [ "GorillaDash-Api-Key": "{{API_KEY}}", "GorillaDash-Api-Secret": "{{GD_RESTFUL_SECRET}}", "X-Requested-With": "XMLHttpRequest", "standard-error-handle": "1", "Content-Type": "application/json" ] let parameters = [ "enquiry_form_slug": "meta-lead-gen", "first_name": "Casper", "last_name": "Lai", "email": "casper@gorilladash.com", "mobile": "+61412345678", "tribe_slug": "fl-demo", "tribe_name": "Demo", "address_1": "2121 Vista Parkway", "locality": "West Palm Beach", "state": "FL", "postal_code": "33411", "country": "US", "latitude": 26.7162238, "longitude": -80.1504443, "ip": "203.0.113.10", "notify": true, "fields": [ [ "name": "Message", "value": "Test" ] ], "tracking_data": [ [ "parameter": "utm_source", "value": "facebook", "path": "/contact-us", "session_at": "2026-08-29T04:12:00Z" ], [ "parameter": "ad_id", "value": "120210000000000000", "path": "string", "session_at": "2024-01-15T09:30:00Z" ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.gorilladash.com/api/v1/enquiries")! 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() ```