Skip to main content
Box is built for content-centric intelligent workflows. Box Automate orchestrates triggers, AI agents, people, and document steps on files and folders that already inherit Box permissions, collaboration, retention, and audit. Box Doc Gen produces business documents from templates and writes them back into that same governed content layer. Learn how to design work around the documents people already use, instead of copying content into a separate automation or AI system.
Box Automate and Box Doc Gen are not included in the Free Developer Plan.

​
Why Box for intelligent workflows

Choose Box when the workflow’s source of truth is enterprise content and you need automation, AI, and document production without leaving that content layer.
  • Content stays governed — Workflows operate on Box files and folders. Access tokens and collaborations still apply; you do not bypass waterfall permissions by using the API. See the .
  • Event-driven and human-driven triggers — Box Automate workflows can start from file/folder events, metadata, tasks, File Request, Box Sign, forms, manual start, or HTTPS.
  • AI as a workflow step — Use Box AI in Automate to extract metadata, summarize content, or answer questions, then route the workflow based on that result.
  • Document production — Box Doc Gen fills Microsoft Word templates from API JSON (or Box Automate outcomes) and writes generated docx or pdf files back into Box.
  • Cross-product handoffs — One Box Automate flow can combine uploads, metadata, Box Doc Gen, Sign, tasks, notifications, and external HTTPS connectors.
  • Developer control — Platform apps authenticate with standard Box auth, call content APIs, start manual workflows, and (where enabled) call Box Automate and Box Doc Gen endpoints.
Box is not a general-purpose iPaaS for arbitrary SaaS-to-SaaS glue that never touches files. It is strongest when the process is document-centric: intake, classification, generation, review, signature, routing, and archival of content that must remain permissioned and auditable.

​
Intelligent workflow capabilities

Box Automate

Native, agentic workflow automation on Box content — triggers, AI agents, outcomes, branching, loops, and variables. Best for new intelligent workflows.

Box Doc Gen

Template-based document generation from templates and structured data.

Box Relay

List and start existing manual-start Box Relay workflows from your app with GET /workflows and POST /workflows/:id/start.
For new builds, use Box Automate. Existing applications that still list or start manual-start workflows can keep using those APIs; prefer Automate for new projects.

​
Choose the right capability

Start with . You get agentic orchestration with triggers, AI, branching, and human review in one runtime. See .
Start with . Content-aware and external triggers start governed runs without custom workers. See .
Use or . Both support programmatic start; prefer Box Automate for new builds when it is enabled.
Start with . It is a purpose-built generation API, and output lands in a Box folder. See .
Use + . Automate can include document generation as an outcome; the Doc Gen API remains available for .
Use . List workflows with and start them with .

​
End-to-end intelligent content workflows

Diagram showing triggers, AI agents, and outcomes running inside Box Automate as the foundation layer on Box, with an HTTP connector
Box Automate is the foundation layer for intelligent content workflows. Triggers, AI agents, and outcomes are Automate workflow steps that run on governed Box content.
  • Triggers — Folder and file events, plus Box Forms, start an Automate run when content or form input arrives.
  • AI agents — Custom agents, Box Extract, and Box AI triage and enrich content inside the same Automate workflow.
  • Outcomes — Add metadata, assign tasks, run file and folder actions, request signatures with Box Sign, generate documents with Box Doc Gen, or call external systems through the HTTP connector.
Automate itself sits on Box, while security and compliance, the content platform, collaboration, and integrations stay underneath every run. Related capabilities often appear in the same solution design:

Box Sign

E-signature requests inside or after a workflow.

File Requests

Intake that can trigger Box Automate.

Box AI Studio

Custom agents used where Box Automate AI features are enabled.

Metadata

Structure used for triggers, branching, and extraction.

Webhooks and events

Alternative or complementary event delivery for custom apps outside the builder.

​
Box Automate

Box Automate is a workflow automation platform built natively on Box. You design workflows as directed graphs: a trigger starts a run, then outcomes execute until the flow ends. The builder supports conditional branching, loops, variables, and data passed between steps — including AI agent output.

​
Why build on Box Automate

You can stitch the same outcomes together with webhooks, custom workers, and direct Box API calls. Box Automate is the better default when you want governed automation rather than another system to operate.

If you build it yourself

  • Host workers, queues, retries, and scheduling
  • Re-implement permission checks on every step
  • Assemble your own audit story across services
  • Wire AI, routing, tasks, and Doc Gen by hand
  • Add custom glue for every new content event

If you build on Box Automate

  • Box runs the workflow runtime, without any automation infrastructure to manage
  • Steps inherit existing permissions and collaborations
  • Activity stays on Box content with enterprise audit and governance
  • Agentic and human steps live in one visual workflow
  • Content-aware triggers start runs for you
Use the Platform APIs when you need fine-grained, app-owned control of a single action. Use Automate when the product is the process: multi-step, content-centric work that must stay secure, observable, and maintainable without a private orchestration stack.

​
Agentic orchestration with Box Automate

Box Automate’s strategic differentiation is agentic orchestration: workflows that do not only move files on fixed rules, but also invoke AI agents, act on their output, and hand off to people or systems when judgment is required. In practice, that means you can:
  • Run custom agents in-flow — Where enabled for your enterprise, Automate AI capabilities work with custom agents that use knowledge sources, citations, and reasoning traces. See and the .
  • Ground agents on Box content — Extraction, summarization, and Q&A run against the files and folders in the workflow, not a disconnected copy of the data.
  • Branch on agent output — Structured AI results become variables and conditions for later outcomes (route, enrich metadata, generate a document, assign a task, or call an external API).
  • Keep humans in the loop — Approval and general tasks sit beside agent steps so irreversible actions (delete, external share, legal send) can require review. Prefer a review step after AI when results must be verified.
  • Orchestrate the full content lifecycle — One workflow can combine intake, agent triage, Doc Gen, Sign, collaboration, notifications, and HTTPS connectors under Box governance.
That combination of agents, content permissions, and durable workflow logic is what makes up a powerful platform for intelligent, agentic workflows. One workflow can also combine intake, agent triage, Doc Gen, Sign, collaboration, notifications, and HTTPS connectors under Box governance.

​
Triggers, outcomes, and logic

Exact trigger and outcome types depend on plan and configuration.
  • File events — Upload, move, copy, download, delete, preview, lock/unlock, watermark removed, collaborator added, classification applied, and file-with-metadata scenarios.
  • Folder events — Create, move, copy, download, delete, or collaborator added.
  • Tasks — General or approval task completion (including accepted/rejected).
  • File Request — Form completion that deposits content into a folder.
  • Box Sign — Completed, declined, expired, or cancelled.
  • Metadata — Template applied or field changes on a file or folder.
  • Manual start — User starts from the Box web app (also startable via API).
  • Form submissions — When Box Forms are enabled for your plan.
  • HTTPS request — An external system starts a run via a unique URL assigned to the workflow.
To learn more, see .

​
Developer integrations

1

Enable Box Automate

Work with your Box admin to enable Box Automate (and related products such as Box AI Studio). See .
2

Start Manual Start workflows

List Manual Start workflows for a folder and trigger them with files and runtime fields (max 20 files per request).
3

Use the Automate Workflows API

Beta Automate Workflows API (v2026.0): and .

​
Box Doc Gen

Box Doc Gen generates business documents (offer letters, contracts, invoices, agreements, and similar) from Box Doc Gen templates stored in Box. Templates are authored in Microsoft Word (add-in or tagging scripts). The API fills tagged fields from JSON and writes output to a destination folder.
Box Doc Gen API is available only for Enterprise Advanced accounts. Currently, template tags are English-only; validate language requirements before production use. Control your own Microsoft Word access to author templates because Box does not control Word licensing.

​
API capabilities

Mark templates

Mark files as Box Doc Gen templates.

Generate documents

Generate documents (single or batch) from templates and API input.

Inspect jobs

Inspect templates and document generation jobs.
All Box Doc Gen API requests must set the box-version header to 2025.0. See .

​
Typical generation flow

1

Use or create a template

Use a predefined sample template or create one with the Box Doc Gen add-in or tagging scripts.
2

Add the template to Box

Upload or mark the file as a Box Doc Gen template in Box.
3

Generate with the API

Call with template file ID, input_source: api, JSON user_input, output_type (docx or pdf), and destination folder.
For more information, see the following developer guides: , , , and .

​
Learn more

Box Automate

Agentic workflows with triggers, AI, branching, and integrations on Box content.

Get started with Box Automate

Enable Box Automate and trigger Manual Start workflows from the API.

Box Automate triggers and logic

Trigger types, outcomes, branching, loops, and variables.

Box Doc Gen

Generate business documents from Word templates and API data.

Box AI Studio

Create and manage custom AI agents used in Automate and Box AI.
Last modified on October 16, 2026