Submit a response
Submits a response to an open form: an optional email plus one answer per field (field answers upsert per response). Public — this is the submission endpoint embedded in the public form flow. Responders are identified by email when provided.
/forms/{form_id}/responsesSubmits a response to an open form: an optional email plus one answer per field (field answers upsert per response). Public — this is the submission endpoint embedded in the public form flow. Responders are identified by email when provided.
Path Parameters
Form ID.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for response submission. Mirrors models.SubmitRequest.
Response Body
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/forms/497f6eca-6276-4993-bfeb-53cbbbba6f08/responses" \ -H "Content-Type: application/json" \ -d '{ "email": "respondent@example.com", "answers": [ { "field_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "answer": { "value": "Jane Doe" } } ] }'{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 400,
"title": "Validation Failed"
}{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 404,
"title": "Not Found"
}{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 409,
"title": "Form Name Taken"
}{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 500,
"title": "Internal Server Error"
}