POST a Form Completion to Formwise

The Data API lets send form responses from third party form builders that can be executed using your form, as if it was filled out traditionally on FormWise.

https://youtu.be/Oik6e7creA8?si=Y9_PrekiI3R4DGZXyoutu.be

Form Completion

POST a Form Completion to Formwise

Some settings such as Web Scraping and Web Searching are unavailable via the API due to timeout issues. Your tool will still run, however it will not conduct any searching.

Post a form completion

post

Sending a form to this endpoint will process as it would a traditional Formwise form submission.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

form_idstringRequired

The Live Form ID of the Form you are processing the responses with.

answer_arraystring[]Required

An array of answers which represent the form response. Ensure the order of the answers matches the order of the questions on your form.

Responses

200

OK: Returns the Response ID of the submitted form.

application/json

400

Bad Request: See Errors Below

post

/wf/form_completion

HTTPcURLJavaScriptPython

POST /api/1.1/wf/form_completion HTTP/1.1
Host: app.formwise.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "form_id": "text",
  "answer_array": [
    "text"
  ]
}

{
  "Response_ID": "1689116584424x9912552851101456000"
}

Headers

Name	Type	Description
Authorization*	Bearer <YOUR-KEY>	Your API Token which can be found on the Account page

Request Body

Name	Type	Description
form_id*	"1679493702554x213757137604050940"	The Live Form ID of the Form you are processing the responses with.
answer_array*	["Yes","No","Maybe","Certainly","Unsure"]	An array of answers which represent the form response. Ensure the order of the answers matches the order of the questions on your form. Example: ["Yes","No","Maybe","Certainly","Unsure"]

200: OK Returns the Response ID of the response if successfully created.

400: Bad Request See Errors Below

After a successful POST, you will see the form response within your Live form responses. You will also receive your own email which is used to reference the account when using Zapier.

Example Response

{
    "Response ID": "1689116584424x991255285110145000"
}