Sign in
Form

Updates a form with given parameters

Add, update, or delete a form's parameters. This will alter how your users/customers will see and interact with the form when sending you files.

Notes

This call will replace your current form in its entirety. If you want to keep any existing elements unchanged, be sure to submit the call with an element's current settings to preserve them.

patch/forms/{id}

Headers

ev-api-keystring required

API Key required to make the API call.

ev-access-tokenstring required

Access token required to make the API call.

Request body

formDescriptionstring

Set a description for the form that will be visible to recipients.

submitButtonTextstring

Text to be displayed on the submission button.

successMessagestring

Text to be displayed when a recipient has submitted the form.

cssStylesstring

Example request

{
  "formDescription": "Send your files",
  "submitButtonText": "Send Files",
  "successMessage": "Your files were uploaded",
  "elements": [
    {
      "id": 123,
      "name": "Your name",
      "type": "name",
      "settings": {
        "isRequired": true
      }
    }
  ],
  "cssStyles": "#ev-widget-form {\n  /*Change this to change the font. Remove to use your website font*/\n  font-family: Helvetica Neue, sans-serif;\n  /*Makes the form the same width as your website */\n  margin: 0 -2%;\n}\n#ev-widget-form label{\n  width: 100%;\n}\n#ev-widget-form input,\n#ev-widget-form textarea {\n  /*Changes color and thickness of borders on form elements */\n  border: 2px solid #ccc;\n  /*Changes spacing inside the form elements (top/bottom and left/right */\n  padding: 5px 5px;\n  /* Changes how far away the inputs are from their label */\n  margin-top: 2px;\n}\n\n#ev-widget-form input:focus,\n#ev-widget-form textarea:focus {\n  /*Changes the color of the form elements when they are clicked in to */\n  border: 2px solid #b2cf88;\n  /*Removes glow effect from form elements that are clicked in to */\n  outline: none;\n}\n\n#ev-widget-form label {\n  font-size: 14px;\n  font-weight: bold;\n  /*Changes color of labels */\n  color: #232323\n}\n\n#ev-widget-form .ev-form-element-description {\n  /*Changes size of descriptions */\n  font-size: 12px;\n  /*Changes color of descriptions */\n  color: #777;\n  /* Changes how far away the descriptions are from their input */\n  margin-top: 2px;\n}\n\n#ev-widget-form textarea {\n  /* Makes textareas (multiline inputs) a taller. */\n  min-height: 90px;\n}     "
}

Response

Successful Operation

FormResponse required— unresolved $ref