The connector will no longer be supported. The Save to wizard will be removed in the next release.

Saving submission data from an automated frevvo form or workflow to your box account, is easily done with the Box connector and the Save to wizard. Once the connector is installed (in-house) and configured, simply run the Save to wizard to connect your form/flow to box. Submissions from  are posted to your box account via the Box Connector and the Doc Action Save to wizard.

You can also choose which documents get saved by checking the document types in the wizard. Documents generated by , e.g. a Government W-4 for an Employee On-Boarding workflow, can be stored with submissions on box.

When the form or flow is submitted, the selected documents, such as Student Registrations, Purchase Orders, mapped PDFS like a W-4, Patient Referrals etc, are uploaded to your box account to the specified folder. Once in box, you can use all their features to collaborate, share and manage the documents.

Signatures are not saved as they are a different content type than attachments.

The Box Connector is available for cloud and in-house  customers. All customers will need a valid Box account.

frevvo only supports/certifies the Box Connector running in the Apache Tomcat container.

In-house customers must perform a few additional configuration steps as described below

On This Page:

Installing the Box Connector

Cloud Customers

If you use the Live Forms Cloud hosted server, the connector is already installed and configured. You can immediately begin to Connect your Forms/Flows using the Save to wizard.

In-house Customers using the frevvo Tomcat bundle

The Box connector can be installed behind your firewall where it can connect to your back end system in order to read/write data. These instructions assume you have an in-house installation of  up and running and you are using the frevvo Tomcat bundle:

To install the Box connector in the same tomcat as :

  1. Stop .
  2. Download the box connector zipflile from here
  3. Extract the box.war file to your <frevvo-home>\tomcat\webapps directory.
  4. Create an Application for Live Forms on
  5. Configure the Box Connector - (In-house only)

Create a Application for Live Forms

You must create a content API application for .

Follow these steps;

  1. Navigate to and signup for an account.
  2. Navigate to the same link and login. Click Getting Started on the My Applications screen.

  3. You are prompted to create an box application. Give the application a unique name (name has to be unique across entire ecosystem of developer applications (both private and public)).

  4. On the General Information section of the screen, the application name and support email will be prefilled. Verify that the Content API Access Only button is checked.

  5. On the OAuth2 Parameters section of the screen,
    1. Copy the client_id and save it somewhere. You will need this to configure the box connector in the file in .
    2. Copy the client_secret and save it somewhere. You will need this to configure the file in .
    3. Enter the base uri for your installation in the redirect_uri field. Change the <your server name> and <port #> shown in the image to your information:
    4. Verify that Read and Write all files and folders stored in box is checked in the Scope section. This is the only scope required by .

  6.  Save the box application.

Configure the Box connector (in-house only)

These instructions assume you are using the frevvo tomcat bundle. The Box connector is configured using properties located in the <frevvo-home>/tomcat/conf/ file.

Follow these steps:

  1. Stop
  2. Navigate to <frevvo-home>\frevvo\tomcat\conf\ directory.

  3. Edit the file.
  4. Locate the Box Connector section of the file.

  5. Add the client id that you copied and saved earlier as the value of the property by pasting it after the equal sign.

  6. Add the client secret that you copied and saved earlier as the value of the property by pasting it after the equal sign.
  7. Remove the # in front of the properties if it is there
  8. Save the changes.

  9. Start . If you are running v7.1+, make sure the Insight server is running before starting .

  10. Browse http://<your server:port>/box/health (replace <your server:port> with your frevvo server:port) to check the status of the connector. If the connector is up and running, you will see { "status" : "UP" }.
  11. Proceed to Connect Forms/Flows with the Save to wizard

Connect Forms and Flows with the Save to wizard

  1. Login to your box account and create a folder for your form/flow. Let's say you have an Employee On-boarding workflow and you want to store all of the submissions in a folder named Employee On-Boarding.

    To ensure interoperability across file systems, it is recommended that you follow a good naming standard such as POSIX when creating files and folders. For example, folder names can't contain slashes so a folder named '1/2/15' would not be valid.

  2. Create your form or flow as usual. Generate a frevvo-PDF,map to your custom PDFs, upload attachments if required.
  3. Login as a  designer user.
  4. Click the Edit icon to open your form/flow.

  5. Click on the what happens to my data? icon on the designer toolbar.

  6. Select the Save to option.

  7. In the wizard that pops up, provide your credentials. You’ll be redirected to login to box if you are logging into your account for the first time.
    1. On successful login, you are asked to either grant or deny permission to the scopes specified in the box application that you created earlier. Click the Grant Access to Box button to continue.

    2. When granted permission, the Oauth token is generated and stored in . The wizard will login to your box account, browse to find available folders and display them.

  8. Select a parent folder (e.g. Employee On-boarding) and a submission folder. Let's say you want the name of the submission folder that contains the documents to be the new employee's First Name and Last Name,. Use a template that’s dynamically generated e.g. {FirstName} {LastName}. You can select the fields in your form/flow by clicking on the dropdown to the right of the Submission folder field.

    Select the types of documents you want to send to box as part of the submission. The choices are:

  9. Click Finish.
  10. Save your form or flow by clicking the save and exit icon.

  • If you do not select a parent and submission folder, submission files are stored under the box account root folder
  • When the parent folder field is specified and the submission folder is not ,submission files are stored under the parent folder.
  • When the submission folder field is specified and the parent folder is not,  a submission folder is created under account root folder.
  • Folder names should not contain a / or \

Check Submissions on

When the form or flow is submitted, the documents will be uploaded to your box account in the specified subfolder. All subfolders reside in the parent folder (Employee On-Boarding in our example).

Once in box, you can use all their features to collaborate, share and manage the submission documents.

Follow these steps to verify your stored submissions on box:

  1. Test your form/flow, fill in data, add attachments, sign the form etc. and submit it.
  2. Login to your box account and navigate to the folder you created earlier. See that it now contains a subfolder. The subfolder is dynamically named based on form data e.g. FirstName and LastName fields in the flow. Every time a workflow is submitted a new subfolder is created in this parent folder.
  3. Inside the subfolder, you’ll see the uploaded files e.g. the frevvo generated PDF, a Federal W-4 and I - 9 and the form xml document. You can click on the PDF to preview it directly in the box UI.

Box will not open files without a file extension. Be sure to include the file extension in the name of any acroforms uploaded to for mapping Pixel Perfect PDFs.

Same Named Files show Revision Number on Box

Typically, a new subfolder is created on Box for each submission. Let's say you decide to send a submission to an existing subfolder and in the submission there are file(s) with the same name as file(s) that are already stored in the existing subfolder, It is reasonable to expect that the existing file will be overwritten by the new file with the same name or there will be 2 files with the same name in the existing subfolder .

Box handles this situation by:

For example, an Employee On-boarding for Max Jones stores mapped PDFs of the I-9, W - 4, Connecticut W - 4 and the workflow after the first submission. Max runs through the  Employee On-boarding a second time resulting in files with the same name as those generated from the first submission. Viewing the subfolder for Max Jones shows revision numbers for version 2 of each file


Some common issues with solutions are listed below.

Doc Post Failure

If the submission doesn't reach, all tenant administrators or flow admins (if configured)  will receive a Doc Post Failure notification email reporting information about the error.

Determine the version of the Box Connector you are using:

To determine the version of the Box connector you are using:

  1. Browse http://<your server:port>/box/info  - the version information is returned as shown in the image.

Monitor Box connector Activity

To monitor Box connector activity:

  1. Browse http://<your server:port>/box/trace  - trace information is returned as shown in the image.

Max file size

The default max file size for all frevvo connectors is set to unlimited. Any size file can be uploaded and posted to box.