Skip to main content
POST
/
apis
/
setting-service
/
public
/
v1
/
forms
/
{form_id}
/
submit
Submit Form Data
curl --request POST \
  --url https://{base-address}/apis/setting-service/public/v1/forms/{form_id}/submit \
  --header 'Content-Type: multipart/form-data' \
  --form 'formData=<string>' \
  --form files='@example-file'
{
  "Status": "success",
  "Data": {
    "item": "<string>"
  }
}
Before calling this endpoint, make sure you’ve generated an API token and picked the correct domain. See Authentication & Base URLs.

Path Parameters

​
form_id
string
required

Unique identifier of the form to submit.

Query Parameters

​
locale
string
required

Specifies the language or region for the response data

Body

multipart/form-data
​
formData
string
required

Stringifying JSON, the key must be "form_mapping", and its value should contain the fields from the selected form builder. For any media field, an additional key in the format "<media_field>_images" must be included, with its value as a list of the original names of uploaded files.

​
files
file

Files to be sent as attachments in notification email (e.g. images uploaded in form).

Response

Submission accepted. Returns submission ID or result message.

​
Status
string

Indicates whether submission succeeded.

Example:

"success"

​
Data
object