Submit a form response

Submits a respondent’s answers for a form. No authentication required. On success, the service stores the submission, increments the form’s submission count, emails recipients (if configured), and returns 201 with no body.

Maximum request size is 250 MB (to support file attachments).

POST /api/forms/{form_id}/submissions

cURL

basic

curl --request POST \
  --url https://api.paubox.com/v1/forms/api/forms/{form_id}/submissions \
  --header 'Content-Type: application/json' \
  --data '
{
  "form_data": {
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "[e-mail]"
  }
}
'

Path Parameters

form_id · string<uuid> · required

UUID of the form being submitted

Body

application/json

form_data · object · required

Key-value pairs matching the form's field schema (form_json). Structure varies per form.

attachments · object[]

Optional file attachments

Show child attributes

Response

201

Submission accepted