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.

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

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

POSThttps://app.formwise.ai/api/1.1/wf/form_completion

Authorization

BearerAuth

Body

application/json

form_id*string

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

answer_array*array of string

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

Response

200400

OK: Returns the Response ID of the submitted form.

Body

application/json

Response_IDstring

Example: "1689116584424x9912552851101456000"

Request

JavaScriptCurlPython

const response = await fetch('https://app.formwise.ai/api/1.1/wf/form_completion', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "form_id": "text",
      "answer_array": [
        "text"
      ]
    }),
});
const data = await response.json();

Response

200

{
  "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"
}