# Box + Krokul CRM

Yes. Krokul CRM integrates with Box. Every client company and deal in Krokul has its own Box folder, invoices and contracts issued in Krokul are saved into it, and files that colleagues or clients upload there appear on the deal card as links. Box permissions and retention rules keep governing the content. The Krokul app in Zapier, Make, n8n or Albato runs the link, and the Krokul API with webhooks serves custom builds.

**Status:** Via API and webhooks. **Automation platforms:** Zapier, Make, n8n, Albato.

## What your team gets

### A folder tree that mirrors the client list

A new client company in Krokul gets a Box folder under the root you picked, and every deal for that client gets a subfolder named after it. The Box folder ID is stored on the Krokul record. A renamed deal or a moved folder keeps its link.

### Uploads to the deal folder show up on the card

Box sends FILE.UPLOADED when a file is uploaded or moved into a watched folder. Krokul attaches it to the matching deal as a link with the file name and the uploader. Engineers drop a revised drawing into Box, and the account manager sees it on the deal the same minute.

### Issued documents are filed for the accountant

When Krokul issues an invoice, act or contract, the connector stores it as a PDF file in the deal folder under the document number. Box metadata on the file carries the deal, the client company and the amount, so finance can search Box by those fields.

### Clients upload without a Box account

From the deal, the manager creates a Box file request for its folder by copying your template request. The client opens the link and uploads scans or specifications. Each upload fires FILE.UPLOADED and lands on the deal like any other file.

### A signed contract moves the deal

A contract saved in the deal folder can go out for signature through Box Sign. SIGN_REQUEST.COMPLETED moves the deal to the stage you chose for signed contracts and adds the signed file to it. SIGN_REQUEST.DECLINED returns the deal to its previous stage with a task for the manager.

## What moves between Box and Krokul

| Box | Krokul | Direction | When |
|---|---|---|---|
| Folder | Client company | Krokul → Box | A client company is created |
| Subfolder | Deal | Krokul → Box | A deal is created |
| PDF file with metadata | Issued document | Krokul → Box | A document is issued or gets a new version |
| FILE.UPLOADED | File link on the deal | Box → Krokul | A file is uploaded or moved into the deal folder |
| File request (copied from a template) | Upload link on the deal | Krokul → Box | The manager asks the client for files |
| SIGN_REQUEST.COMPLETED, SIGN_REQUEST.DECLINED | Deal stage and signed file | Box → Krokul | A signer finishes or declines |
| COMMENT.CREATED | Comment in the deal feed | Box → Krokul | Someone comments on a file in the deal folder |

## How to connect today

### Krokul app in Zapier, Make, n8n or Albato

1. Connect the Krokul app with a Krokul API key and Box with a user who can create folders under your chosen root.
2. Pair the Krokul trigger New Client Company or Deal Won with the Box actions Create Folder and Create Shared Link on Folder.
3. For the way back, start from the Box trigger New File in Zapier, New File Event in Make or File uploaded (Beta) in Albato, and add the link to the deal in Krokul.

### Custom flow through the Krokul API and webhooks

1. Issue a Krokul API key with scopes for client companies, deals and files.
2. Subscribe to clientCompany.created and card.created with webhook/api-upsert, verify x-crm-signature, create the Box folder and bind its ID to the record with externalRef/api-upsert.
3. Create a Box webhook on each deal folder for FILE.UPLOADED and check BOX-SIGNATURE-PRIMARY or BOX-SIGNATURE-SECONDARY on every delivery.
4. Resolve the folder ID to a deal with externalRef/api-resolve and attach the file with file/api-create.

**Triggers:** New File; New Folder; New Comment; Task Assigned to You; New File Event; New Folder Event; File uploaded (Beta).

**Actions:** Create Folder; Upload File; Create Shared Link on File; Create Shared Link on Folder; Add Metadata to File; Add Comment to File; Find a File; Find a Folder; Find All Box Sign Requests.

### For integrators

Box signs webhook payloads with HMAC-SHA256 over the raw body and the BOX-DELIVERY-TIMESTAMP value, using a primary and a secondary key so keys can rotate. Payloads older than ten minutes should be rejected. FILE.UPLOADED and FOLDER.CREATED are set on folders only, so the listener subscribes per deal folder. In Krokul, file/api-create attaches a link to exactly one record, and external keys tie each record to its Box folder ID.

[API documentation](https://app.krokul.com/api/v1/docs)

## Questions and answers

### Does Krokul integrate with Box?

Yes. Krokul integrates with Box through the Krokul app in Zapier, Make, n8n and Albato, and through its API and webhooks.

### Does Krokul copy files out of Box?

No. Files stay in Box with their permissions. Krokul writes its own issued documents into Box and keeps links to the rest.

### Which Box event puts a new file on the deal?

FILE.UPLOADED. Box sends it for files uploaded or moved into a watched folder, and Krokul matches the folder to the deal through its external key.

### Can a client send files to a deal without a Box login?

Yes. The manager creates a Box file request for the deal folder, and anyone with the link can upload. Box creates new file requests by copying an existing one, so the account keeps one template request.

## Limits

File contents, versions, collaborators, classification and retention live in Box. Krokul keeps a link, a name and a note for each file and opens the preview in Box.

## Related services

- [Dropbox](https://krokul.com/en/integrations/dropbox/index.md)
- [Google Drive](https://krokul.com/en/integrations/google-drive/index.md)
- [OneDrive and SharePoint](https://krokul.com/en/integrations/onedrive-sharepoint/index.md)
- [DocuSign](https://krokul.com/en/integrations/docusign/index.md)
- [Dropbox Sign](https://krokul.com/en/integrations/dropbox-sign/index.md)
- [Notion](https://krokul.com/en/integrations/notion/index.md)

[Files and documents](https://krokul.com/en/integrations/category/files-docs/index.md)

Box is a trademark of Box, Inc. Krokul is not affiliated with Box.

Updated: 2026-10-15

---

App: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs