Skip to main content
POST
/
forms
/
create
Create form
curl --request POST \
  --url https://api.octaviatech.app/cms/forms/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "title": {
    "en": "Contact Us",
    "es": "Contáctanos"
  },
  "slug": "contact-us",
  "description": {
    "en": "Public contact form",
    "es": "Formulario público"
  },
  "submitButtonText": {
    "en": "Send",
    "es": "Enviar"
  },
  "sections": [
    {
      "title": {
        "en": "Basic info",
        "es": "Datos básicos"
      },
      "fields": [
        {
          "name": "fullName",
          "type": "text",
          "label": {
            "en": "Full Name",
            "es": "Nombre completo"
          },
          "required": true
        },
        {
          "name": "email",
          "type": "email",
          "label": {
            "en": "Email",
            "es": "Correo"
          },
          "required": true
        },
        {
          "name": "message",
          "type": "textarea",
          "label": {
            "en": "Message",
            "es": "Mensaje"
          },
          "required": true
        }
      ]
    }
  ],
  "isActive": true
}'
{
  "success": true,
  "statusCode": 201,
  "message": "Created",
  "data": {
    "id": "{{objectId}}",
    "slug": "contact-us"
  }
}

Authorizations

x-api-key
string
header
required

Body

application/json
title
object
required

Multilingual title (Map-like)

slug
string
required

URL-friendly unique identifier (unique per tenant)

sections
object[]
required
description
object

Multilingual description

submitButtonText
object

Multilingual submit button text

isActive
boolean

Whether the form is enabled (default true)

Response

Created

The response is of type any.