Before you start
Make sure you have:- A Box plan that includes Box Sign for integrations — Box Business plans and up include Box Sign API access.
- A Box admin who can allow apps — if your Box blocks apps it hasn’t approved, a Box admin needs to allow the Veles app first. See If your Box blocks unlisted apps.
- Veles admin access — only Veles admins can set up Box Sign.
- A Box account for every rep who sends — reps send from their own Box account, not a shared one.
If your Box blocks unlisted apps
Some Box accounts only allow apps a Box admin has approved. If yours does, Box won’t let Veles in until your Box admin allows the Veles app. Veles shows: “Box didn’t let Veles in. Your company’s Box admin may need to allow the Veles app first.” If the sign-in fails for another reason, Veles shows: “Box sign-in didn’t finish. Try again, or ask your Box admin whether the Veles app is allowed.”Find the Client ID
The Box Sign setup page in Veles (Admin Console > Order Forms & E-signature, then Configure on the Box Sign card) shows the Veles app’s Client ID:- Before anyone connects — under the Connect Box button.
- After a failed Box sign-in — in a help box at the top of the page. Click Copy Client ID next to it to copy it. The help box doesn’t show if you declined the request on Box’s approval screen: sign in again and approve it instead.
Allow the Veles app in Box
1
Open Platform Apps Manager
Your Box admin goes to Admin Console > Integrations > Platform Apps Manager in Box.
2
Add and enable the Veles app
They add the app with the Client ID from the Veles setup page, and enable it.
3
Connect again
The Veles admin comes back to the Box Sign setup page and connects Box again: Connect Box, or Reconnect if Box was already connected.
Veles support at hi@getveles.com can also give you the Client ID.
Admin setup
1
Open the Box Sign settings
In Veles, go to Admin Console > Order Forms & E-signature. Under E-signature, find the Box Sign card and click Configure.
2
Connect Box
Click Connect Box and sign in with your Box account. Approve the request so Veles can access your Box. You’ll be brought back to the Box Sign page, which shows Connected and the Box account you used.
3
Choose the filing folder
Under Filing Folder, open folders until you find the one for signed order forms. Click Use this folder on its row, or open it and click Use “folder name”. You can’t use the top level of Box (All Files).Then share the folder with your reps in Box. They need access to it to send order forms, and upload rights (Editor), because Veles files the signed copies there. An easy way is to invite your sales team’s Box group to the folder as editors.
4
Turn on Box Sign
Go back to Admin Console > Order Forms & E-signature. On the Box Sign card, click Use. The card now shows In use.
If the admin who connected Box is no longer active in Veles, another admin needs to reconnect Box.
Connecting reps
Each rep sends from their own Box account. A rep connects it in one of two ways:- From their settings — open the user menu, choose My Settings > Integrations, and click Connect & Configure next to Box.
- The first time they send — Veles shows Connect your Box account in place of the send button. After signing in to Box, the rep comes back to the order.
Sending an order form
1
Start the send
On a finalized order, click Send for Signature. Add the customer’s signers under Counterparty and your team’s under Internal signers, then send.
2
Open the draft in Box
Veles generates the order form and creates a draft in Box. Click Open in Box to review and send.
3
Place fields and send
In Box, place the signature and other fields on the document, then send it.
Cancelling and voiding
Cancel the signature request. On the order, click Cancel signature request. Box cancels the request, and the order goes back to Finalized so you can revise the documents and send again. Void the order. Clicking Void & Revise and then Void Order also cancels the Box request. Box only lets the rep who sent a request cancel it. If that rep’s Box connection has lapsed, or Box refuses the cancel, Veles still cancels it in Veles. Every admin then gets a notification: “Could not cancel in Box Sign: cancel it there”. The request is still live in Box and the customer can still sign it, so someone needs to cancel it in Box by hand.A signature that arrives after a cancel
Sometimes a customer signs just as the request is cancelled. When that signature reaches Veles, Veles accepts it and the order moves on as signed. Veles does not accept it when:- the order was voided,
- the order was sent for signature again, or
- Box could not cancel the request (see above).
Where signed documents go
When an order form is signed:- In Box — the signed copy and its signing log are filed in your filing folder, in a subfolder per customer. For example, “Signed Order Forms / Acme Corp”. Veles creates the subfolder the first time it sends for that customer.
- In Veles — the signed agreement is attached to the order, and the order is ready to execute.
Troubleshooting
Box sign-in fails
- “Box access was not granted” — sign in again and approve the request.
- “Box didn’t let Veles in” — your Box admin needs to allow the Veles app. See If your Box blocks unlisted apps.
- “Box sign-in didn’t finish” — try again. If it keeps failing, ask your Box admin whether the Veles app is allowed.
Box Sign shows “Not connected” on Order Forms
- An admin needs to connect Box and choose a filing folder on the Box Sign page. Use appears on the card once both are done.
A rep can’t send
- If Veles says “Your Box account doesn’t have access to the order forms folder”, share the filing folder with that rep in Box as an editor.
- If the rep’s Box connection has expired, they reconnect from My Settings > Integrations.
- “Box isn’t set up for this account yet. Ask an admin to connect Box first.” — reps can connect their Box only after an admin connects Box on the Box Sign setup page. See Admin setup.
The filing folder was deleted or moved
- The Box Sign page shows the problem under Setup Required. Click Change under Filing Folder and choose a folder again.
What’s next
Order form templates
Set up the order form Veles sends for signature.
Contract management
What happens after an order is signed and executed.

