API - POST Form Submission

Use our API to simply integrate HeadlessForms into your project.

https://api.headlessforms.cloud/api/v1/form/{FORM_TOKEN}

Request Example

Headers

Key	Value
Content-Type	application/json
Accept	application/json

Request Body

{
  "name": "John Doe",
  "email": "john@mail.com"
}

CURL request

curl --location --request POST 'https://api.headlessforms.cloud/api/v1/form/{FORM_TOKEN}' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
	"name": "John Doe",
	"email": "john@mail.com"
}'

Possible Responses

Success (200 OK)

{
  "status": 200,
  "error": null,
  "message": "Submission Stored",
  "data": []
}

Validation (Error 422 Unprocessable Entity)

{
  "status": 422,
  "error": "Validation Failed",
  "message": "Error",
  "data": {
    "email": [
      "The email must be a valid email address."
    ]
  }
}

Form Token Expired (403 Forbidden)

{
  "status": 403,
  "error": "Form Token Expired",
  "message": "Error",
  "data": []
}

Unknown Domain (403 Forbidden)

{
  "status": 403,
  "error": "Access Denied",
  "message": "Error",
  "data": []
}