Forms
Update a form
Changes a form. Send only the fields to change, inside a form object.
- Set
form_typetopost_purchaseto show the form after payment at enrollment checkout, or togeneralfor a standalone form you share or embed.pre_purchaseis retired and returns 422; an existing pre-purchase form stays editable as long as the request doesn’t name that type. - Set
country_idsto choose the countries the form is for. This replaces the current list. - Set
statustoactiveto publish the form. Activating a form gives it a public token if it has none and sends theform_activatedwebhook event. - Send
form_componentsto change the form’s elements.
Every update sends the form_updated webhook event. Returns 404 when the form isn’t one of your company’s, and 422 when a value is invalid.
PUT
/
api
/
forms
/
{id}
curl --request PUT \
--url https://api.fluid.app/api/forms/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"form": {
"status": "active"
}
}
'{
"message": "Form updated successfully",
"form": {
"id": 4136,
"title": "Enrollment - Canada",
"status": "active",
"description": "Tax and payout details we need before we can pay your commissions in Canada.",
"form_type": "post_purchase",
"form_redirect": null,
"updated_at": "2026-10-07T15:31:40Z",
"form_components": "[{\"element_type\":\"input\",\"puck_type\":\"legal_name\",\"label\":\"Legal name\",\"placeholder\":\"As it appears on your tax return\",\"required\":true,\"sensitive_info\":false,\"is_form_field\":true,\"id\":18321},{\"element_type\":\"input\",\"puck_type\":\"date_of_birth\",\"label\":\"Date of birth\",\"placeholder\":\"MM/DD/YYYY\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18322},{\"element_type\":\"short_text_entry\",\"puck_type\":\"short_text_entry\",\"label\":\"Social Insurance Number (SIN)\",\"placeholder\":\"123 456 789\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18323},{\"element_type\":\"multiple_choice_entry\",\"puck_type\":\"multiple_choice_entry\",\"label\":\"How did you hear about Dunder Mifflin?\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"multiple_choice_options\":[{\"label\":\"Social media\"},{\"label\":\"A friend or family member\"},{\"label\":\"A rep\"},{\"label\":\"Search\"},{\"label\":\"An event\"},{\"label\":\"Other\"}],\"id\":18324}]",
"countries": [
{
"id": 39,
"name": "Canada",
"iso": "CA"
}
],
"form_styles": null,
"form_respondents_count": 0,
"public_token": "c9Lw2Rk7VbN4xQe8ZtYm3A",
"embed_settings": {
"password_protected": false
},
"embed_url": "https://forms.fluid.app/c9Lw2Rk7VbN4xQe8ZtYm3A?embed=true",
"share_url": "https://forms.fluid.app/c9Lw2Rk7VbN4xQe8ZtYm3A"
},
"meta": {
"request_id": "4f8b2d6e-1a93-4c57-b0e2-9d6a3f7c8e14",
"timestamp": "2026-10-07T15:31:40Z"
}
}Body
application/json
⌘I
curl --request PUT \
--url https://api.fluid.app/api/forms/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"form": {
"status": "active"
}
}
'{
"message": "Form updated successfully",
"form": {
"id": 4136,
"title": "Enrollment - Canada",
"status": "active",
"description": "Tax and payout details we need before we can pay your commissions in Canada.",
"form_type": "post_purchase",
"form_redirect": null,
"updated_at": "2026-10-07T15:31:40Z",
"form_components": "[{\"element_type\":\"input\",\"puck_type\":\"legal_name\",\"label\":\"Legal name\",\"placeholder\":\"As it appears on your tax return\",\"required\":true,\"sensitive_info\":false,\"is_form_field\":true,\"id\":18321},{\"element_type\":\"input\",\"puck_type\":\"date_of_birth\",\"label\":\"Date of birth\",\"placeholder\":\"MM/DD/YYYY\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18322},{\"element_type\":\"short_text_entry\",\"puck_type\":\"short_text_entry\",\"label\":\"Social Insurance Number (SIN)\",\"placeholder\":\"123 456 789\",\"required\":true,\"sensitive_info\":true,\"is_form_field\":true,\"id\":18323},{\"element_type\":\"multiple_choice_entry\",\"puck_type\":\"multiple_choice_entry\",\"label\":\"How did you hear about Dunder Mifflin?\",\"required\":false,\"sensitive_info\":false,\"is_form_field\":true,\"multiple_choice_options\":[{\"label\":\"Social media\"},{\"label\":\"A friend or family member\"},{\"label\":\"A rep\"},{\"label\":\"Search\"},{\"label\":\"An event\"},{\"label\":\"Other\"}],\"id\":18324}]",
"countries": [
{
"id": 39,
"name": "Canada",
"iso": "CA"
}
],
"form_styles": null,
"form_respondents_count": 0,
"public_token": "c9Lw2Rk7VbN4xQe8ZtYm3A",
"embed_settings": {
"password_protected": false
},
"embed_url": "https://forms.fluid.app/c9Lw2Rk7VbN4xQe8ZtYm3A?embed=true",
"share_url": "https://forms.fluid.app/c9Lw2Rk7VbN4xQe8ZtYm3A"
},
"meta": {
"request_id": "4f8b2d6e-1a93-4c57-b0e2-9d6a3f7c8e14",
"timestamp": "2026-10-07T15:31:40Z"
}
}