Upsert Form | Gorilla Dash

curl -X PUT https://api.gorilladash.com/api/v1/website-content/forms/upsert \
     -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 the form, or updates the one with the same slug. Needs a key with Website Content: Read and Write (website-content:write).

The body and rules are the same as Create Form. Sending an identical payload again writes nothing: no duplicate, the id is kept and updated_at does not change, so a migration can be re-run safely.

A deleted form with the same slug is restored. A slug that belongs to a tribe’s form returns 409; edit that form in Gorilla Dash.

Request

This endpoint expects an object.

slugstringRequired

namestringRequired

statusstringRequired

notify_emailslist of stringsRequired

fieldslist of objectsRequired

Response

Created

successboolean

statusinteger

dataobject

Headers

Request

Response