Forms
Respond to a form
Saves one submission of a form and marks it completed. Who can call it:
- A signed-in member of the form’s company can answer any of the company’s forms, including drafts. The answers are filed under their membership, and
contactis ignored. - Anyone else can answer only an
activeform, and must sendcontactwith anemail. The answers are filed under a new contact of the form’s company. Unauthenticated calls are deprecated and return aDeprecation: trueheader: collect public answers through the form’s public token instead.
Every form_element_id must belong to this form. This endpoint doesn’t check required elements or the form’s type and countries. A submission sends the form_submitted webhook event. Returns 404 when the form doesn’t exist or the caller can’t answer it.
POST
/
api
/
forms
/
{id}
/
respond
curl --request POST \
--url https://api.fluid.app/api/forms/{id}/respond \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"form_response": {
"responses": [
{
"form_element_id": 18341,
"answer": "A friend or family member"
},
{
"form_element_id": 18342,
"answer": "Delivery to the Scranton Business Park arrived a day early."
}
]
}
}
'{
"message": "Responses created successfully",
"responses": [
{
"id": 512214,
"form_element_id": 18341,
"form_respondent_id": 77162,
"response": "A friend or family member",
"created_at": "2026-10-07T15:52:06.418Z",
"updated_at": "2026-10-07T15:52:06.418Z",
"uuid_v7": "01a11710-9a12-7e80-bd98-e18068e45f85"
},
{
"id": 512215,
"form_element_id": 18342,
"form_respondent_id": 77162,
"response": "Delivery to the Scranton Business Park arrived a day early.",
"created_at": "2026-10-07T15:52:06.418Z",
"updated_at": "2026-10-07T15:52:06.418Z",
"uuid_v7": "01a11710-9a12-7c3c-bef0-8ff45a3c5da0"
}
],
"meta": {
"request_id": "7a5c2e9b-4f81-4d36-a0b9-3e6d8c1f5a42",
"timestamp": "2026-10-07T15:52:06Z"
}
}⌘I
curl --request POST \
--url https://api.fluid.app/api/forms/{id}/respond \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"form_response": {
"responses": [
{
"form_element_id": 18341,
"answer": "A friend or family member"
},
{
"form_element_id": 18342,
"answer": "Delivery to the Scranton Business Park arrived a day early."
}
]
}
}
'{
"message": "Responses created successfully",
"responses": [
{
"id": 512214,
"form_element_id": 18341,
"form_respondent_id": 77162,
"response": "A friend or family member",
"created_at": "2026-10-07T15:52:06.418Z",
"updated_at": "2026-10-07T15:52:06.418Z",
"uuid_v7": "01a11710-9a12-7e80-bd98-e18068e45f85"
},
{
"id": 512215,
"form_element_id": 18342,
"form_respondent_id": 77162,
"response": "Delivery to the Scranton Business Park arrived a day early.",
"created_at": "2026-10-07T15:52:06.418Z",
"updated_at": "2026-10-07T15:52:06.418Z",
"uuid_v7": "01a11710-9a12-7c3c-bef0-8ff45a3c5da0"
}
],
"meta": {
"request_id": "7a5c2e9b-4f81-4d36-a0b9-3e6d8c1f5a42",
"timestamp": "2026-10-07T15:52:06Z"
}
}