---
sourceDocument: Brazil Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Box Spoke

# Box Spoke {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 11 minutes to read  
Move attachments to Box where they can be managed as shared documents.

## Request apps on the Store {#box-spoke__section_gw5_x2f_mjb}

Visit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).{#box-spoke__inline-send-to-store}

## Integration Hub subscription {#box-spoke__section_rsf_yvb_l3b}

This spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).

## Spoke version {#box-spoke__section_yf2_tdv_bsb}

Box spoke v3.7.0 is the latest version. For version history of the spoke, see [Box Spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-box.html).{#box-spoke__box-ver}

## Supported versions {#box-spoke__section_zjt_sh4_zgb}

API version v2.

## Spoke requirements {#box-spoke__section_tb5_ymx_p1c}

Ensure that same languages are selected in your ServiceNow instance and Box account.  
* In your ServiceNow instance, select the required language by navigating to User ProfilePreferencesDisplay.

* In your Box account, select the required language by navigating to Account SettingsAccountGeneral Options.

{#box-spoke__ul_khm_znx_p1c}

## Spoke flows {#box-spoke__section_y1q_3h4_gfb}

The Box spoke provides sample flows in the draft state to demonstrate automating Box tasks. To customize a sample flow, copy it to a new application scope. Available sample flows
include:  
{#box-spoke__table_q45_mh4_gfb__entry__2}

| Flow | Description |
|-|-|
| Move Attachment when created to Box | Moves attachment files from ServiceNow to Box when a new attachment record is added. Updates the trigger record with a shared link to the moved attachment file on Box. |
| On-boarding user | Creates a user in Box when you create a ServiceNow user in the Box User group. |
[ ]

{#box-spoke__table_q45_mh4_gfb}

## Spoke actions {#box-spoke__section_zqb_zzn_gfb}

The Box spoke provides actions to automate Box tasks when events occur in ServiceNow. Available actions include:  
{#box-spoke__table_qpz_ktb_x2b__entry__3}

| Category | Action | Description |
|-|-|-|
| Box AI Management | Ask Question | Sends a prompt to the supported AI models using the provided context and returns a brief answer focused on the user's question. |
| Box AI Management | Extract Metadata Freeform | Sends a context‑aware request to supported AI models and extracts metadata as structured key‑value pairs. |
| Box AI Management | Look up AI Agent Default Configuration | Retrieves the default configuration settings for the specified AI agent. |
| Box Hub Management | Look up Box Hub Info by ID | Retrieves details for a Box Hub using the specified Hub ID. |
| Box Hub Management | Look up Box Hub Items Stream | Retrieves all items associated with the specified Box Hub. |
| Box Hub Management | Look up Box Hubs Stream | Retrieves all Box Hubs available to the requesting user based on the Box credentials used to generate the access token. |
| Document Management | Add Metadata to File | Stores the provided attributes information by adding it as metadata for Box files. |
| Document Management | Attach Box File to Record | Copies a file from Box and attaches it to the specified ServiceNow record. |
| Document Management | Lookup File ID | Retrieves the ID of the specified file in Box. |
| Document Management | Move Owned Item | Moves all items owned by the specified user in Box to the specified folder. |
| Document Management | Remove File | Removes the specified file from Box. |
| Document Management | Search Content Stream | Searches for files, folders, web links, and shared files across the user's content or across the entire enterprise. |
| Document Management | Upload File | Uploads the specified file to Box. |
| Document Management | Look up Archives Stream | Retrieves all available archives from the Box application. |
| Document Sharing | Add Collaborator | Grants a user or group a specified level of access to a particular file or folder. Collaborators have one of these access levels. * Co-Owner * Editor * Previewer * Preview Uploader * Uploader * Viewer * Viewer Uploader {#box-spoke__ul_ybd_n5b_x2b} |
| Document Sharing | Create Shared Link | Create a direct and read-only link to a file or folder in Box. |
| Document Sharing | Look up Folder Collaborators By ID | Retrieves all the collaborators associated to the specified folder ID. |
| Document Sharing | Remove Collaborator | Removes the specified collaboration from a file or folder in Box. |
| File Management | Look up File Information | Retrieves detailed information for the specified file. |
| Folder Management | Create Folder | Creates a folder in Box on behalf of the specified Box user account. |
| Folder Management | Delete Folder | Deletes the specified folder in Box. |
| Folder Management | Lookup Folder ID | Retrieves the ID of the specified folder in Box. Note: Items added to Box require 10 minutes to become accessible. For example, if one action creates a folder, a Lookup Folder ID action won't return results until after 10 minutes have passed. |
| Folder Management | Look up Folder Information | Retrieves details for the specified folder. |
| Folder Management | Look up Folder Items Stream | Retrieves all items within the specified folder, including files, subfolders, and web links. |
| Group Management | Create Group | Creates a group in Box with the specified invitation preferences. |
| Group Management | Delete Group | Deletes the specified group in Box. |
| Group Management | Update Group | Updates the specified group in Box with the specified preferences. |
| Legal Hold Management | Assign Legal Hold Policy | Assigns a legal hold policy to a file, file version, folder, or user. |
| Legal Hold Management | Create Legal Hold Policy | Creates a legal hold policy. |
| Legal Hold Management | Look up All Legal Hold Policies Stream | Retrieves a list of legal hold policies of an enterprise. |
| Legal Hold Management | Look up Legal Hold Policy Assignment by ID | Retrieves a legal hold policy assignment for the specified ID. |
| Legal Hold Management | Look up Legal Hold Policy Assignments Stream | Retrieves a list of items assigned to a legal hold policy. |
| Legal Hold Management | Look up Legal Hold Policy by ID | Retrieves a legal hold policy for the specified ID. |
| Legal Hold Management | Remove Legal Hold Policy | Deletes an existing legal hold policy. |
| Legal Hold Management | Unassign Legal Hold Policy | Removes the assignment of an item to a legal hold. |
| Legal Hold Management | Update Legal Hold Policy | Updates a legal hold policy. |
| Metadata Management | Look up Metadata Instance on File By File ID | Retrieves the metadata instance of the file with the specified file ID. |
| Metadata Management | Look up Metadata Instance on File by Scope and Template Key | Retrieves the metadata instance of a folder with the specified scope and template key. |
| Metadata Management | Look up Metadata Instance on Folder By Folder ID | Retrieves all the metadata of the folder with the specified folder ID. Note: Don't use this action on a root folder that has a folder ID value as zero. |
| Metadata Management | Look up Metadata Instance on Folder by Scope and Template Key | Retrieves all the metadata of a folder with the specified scope and template key. |
| Metadata Management | Query Files or Folders by Metadata Stream | Searches for files or folders using SQL-like syntax and returns the matching results. |
| Retention Policy Management | Assign Retention Policy | Assigns a retention policy to an item. |
| Retention Policy Management | Create Retention Policy | Creates a retention policy. |
| Retention Policy Management | Look up Retention Policies | Retrieves all the retention policies of an enterprise. |
| Retention Policy Management | Look up Retention Policy Assignment By ID | Retrieves the retention policy with the specified ID. |
| Retention Policy Management | Look up Retention Policy Assignments Stream | Returns a list of all retention policy assignments associated with a specified retention policy. |
| Retention Policy Management | Look up Retention Policy by ID | Retrieves the retention policy with the specified ID. |
| Retention Policy Management | Update Retention Policy | Updates a retention policy. |
| User Management | Add User to Group | Adds the specified user to the specified group in Box. |
| User Management | Create User | Creates a user account in Box. |
| User Management | Delete User | Deletes the specified user in Box. |
| User Management | Disable User | Sets the status of the specified user in Box to inactive. |
| User Management | Enable User | sets the status of the specified user in Box to active. |
| User Management | Lookup User ID | Retrieves the ID of the specified user in Box. |
| User Management | Update User | Updates the specified user in Box with the specified role changes. |
| Webhook Management | Create Webhook | Creates a webhook. |
| Webhook Management | Look up Webhook By ID | Retrieves the webhook with the specified ID. |
| Webhook Management | Look up Webhooks Stream | Retrieves all the defined webhooks for the specified application. |
| Webhook Management | Remove Webhook | Removes a webhook. |
| Webhook Management | Update Webhook | Updates a webhook. |
[ ]

{#box-spoke__table_qpz_ktb_x2b}

## Available AI agents {#box-spoke__section_x1t_1kc_1fc}

Install Now Assist for Integration Hub and start using the available AI agents. For more information, see [Now Assist for Integration Hub](https://www.servicenow.com/docs/XkEXM~jC9ZOQ1CzB~K0s4A "Use the ServiceNow Now Assist AI agents to mimic human-like intelligence by using Large Language Models (LLMs) to perform tasks that range from simple automated responses to complex problem-solving. Utilize the conversational ability of Integration Hub spoke actions.").  
This spoke provides standalone AI agents that mimic human-like intelligence to perform tasks in your ServiceNow instance.

* In the ServiceNow agentic system, you can create an agentic workflow that comprises of a set of large language model (LLM) instructions along with one or more standalone AI agents to execute an objective. See [Create an agentic workflow](https://www.servicenow.com/docs/access?context=configure-use-case-ai-agents&version=brazil&pubname=brazil-intelligent-experiences&ft:locale=en-US) for information about adding AI agents to create agentic workflows as per your requirement and provide the required trigger.

  You can also search for other
  available AI agents and add them to your agentic workflow. See [Find AI agents](https://www.servicenow.com/docs/access?context=find-ai-agents&version=brazil&pubname=brazil-intelligent-experiences&ft:locale=en-US) for more information.
* You can create a clone of the required spoke AI agent and customize it as per your requirement. See [Duplicate an AI agent](https://www.servicenow.com/docs/access?context=clone-ai-agent&version=brazil&pubname=brazil-intelligent-experiences&ft:locale=en-US) for more information about creating a clone.
* See [AI Agent Studio (legacy)](https://www.servicenow.com/docs/access?context=na-ai-agents&version=brazil&pubname=brazil-intelligent-experiences&ft:locale=en-US) for information about AI agents.
{#box-spoke__ul_tjz_vtr_m2c}  
Available AI agents include: {#box-spoke__table_tmt_mkc_1fc__entry__2}

| AI agent | Description |
|-|-|
| Box user management AI agent | Manages user management tasks (that is, adds a user to group, enables a user, create user, delete user, update user, look up user ID, disable user) in Box. |
| Box folder management AI agent | Manages folder management tasks (that is, create a folder, look up the folder ID, delete a folder) in Box. |
| Box document sharing AI agent | Manages document sharing tasks (that is, remove a collaborator, add a collaborator, create a shared link, look up the folder collaborators by ID) in Box. |
| Box group management AI agent | Manages group management tasks (that is, update a group, create a group, delete a group) in Box. |
| Box metadata management AI agent | Manages metadata retrieval tasks (that is, look up a metadata instance on a file by scope and template key, look up a metadata instance on a folder by folder ID, look up a metadata instance on a folder by scope and template key, look up a metadata instance on a file by file ID) in Box. |
| Box retention policy management AI agent | Manages retention policy management tasks (that is, update a retention policy, look up a retention policies stream, look up a retention policy assignment by id, look up a retention policy by id, look up a retention policy assignments stream) in Box. |
| Box document management AI agent | Manages document management tasks (that is, remove a file, attach a box file to a record, upload a file, move an owned item, search a content stream, look up a file ID, add metadata to a file) in Box. |
| Box legal hold management AI agent | Manages legal hold management tasks (that is, create a legal hold policy, look up a legal hold policy assignment by ID, update a legal hold policy, look up all legal hold policies stream, look up a legal hold policy by ID, unassign a legal hold policy, remove a legal hold policy, look up a legal hold policy assignments stream) in Box. |
[ ]

{#box-spoke__table_tmt_mkc_1fc}

There might be AI agents installed on your instance that are not used in agentic workflows. To learn how to see all agents that are available to you, see [Find AI agents](https://www.servicenow.com/docs/access?context=find-ai-agents&version=brazil&pubname=brazil-intelligent-experiences&ft:locale=en-US).  
Note:  
Ensure that the user running an AI agent has the required roles and permissions to access data or perform operations on data in the table that is associated with the AI agent.

## Spoke triggers {#box-spoke__section_qx5_3sj_mhc}

ServiceNow supports specific events on Box that create triggers. You must first configure a flow with a supported trigger definition. When an event, for example, a push request, occurs on the Box, it
sends the payload via a webhook to the ServiceNow instance. After that, the flow that you configured is triggered at the ServiceNow instance to automate a workflow.
The supported events are:  
{#box-spoke__table_cjy_lsj_mhc__entry__3}

| Category | Trigger | Description |
|-|-|-|
| File Management | File Downloaded | Flow is triggered when a file is downloaded. |
| File Management | File Locked | Flow is triggered when a file is locked. |
| File Management | File Moved | Flow is triggered when a file is moved. |
| File Management | File Renamed | Flow is triggered when a file is renamed. |
| File Management | File Unlocked | Flow is triggered when a file is unlocked. |
| File Management | File Uploaded | Flow is triggered when a file is uploaded. |
| Folder Management | Folder Created | Flow is triggered when a folder is created. |
| Folder Management | Folder Downloaded | Flow is triggered when a folder is downloaded. |
| Folder Management | Folder Moved | Flow is triggered when a folder is moved. |
| Folder Management | Folder Renamed | Flow is triggered when a folder is renamed. |
[ ]

{#box-spoke__table_cjy_lsj_mhc}

For information about setting up the triggers for the Box spoke, see [Set up triggers for the Box spoke](https://www.servicenow.com/docs/lAZBeDSfPGmdqLxoHUpXXA#box-spk-triggers-setup "Set up the trigger to generate the secret and callback URL on your ServiceNow instance."). For more information about inbound integration, see [Conditional and event-driven inbound integration](https://www.servicenow.com/docs/RXSgL647whSD9K8Wi3U4Zw "Integration Hub enables both conditional and event-driven inbound integration with third-party applications.").

## Spoke user roles {#box-spoke__section_mf3_kk5_whc}

The following user roles are available with the spoke:

* Policy User (sn_box_spoke.box_policies_user): Users with this role have access only to Retention Policies module.
* Legal Hold Policy User (sn_box_spoke.legal_hold_policy_user): Users with this role have access only to the Legal Hold Policies module.
* Box Webhook Registry User (sn_box_spoke.box_webhook_registry_user): Users with this role have access only to the Box Webhook Registry module.
{#box-spoke__ul_rk3_mk5_whc}

## Box spoke module {#box-spoke__section_v4c_1f5_fpb}

Bi-directional webhooks can be set up to be notified about the required events. A webhook registry defines the conditions that must be met to notify the ServiceNow app. These conditions are based on the events in Box that you
want to be notified about. When the conditions are met, the specified trigger name triggers the associated subflow, which in turn automates the Box tasks.  
Webhooks require separate setup and can be used independently without using the spoke actions. The Box spoke adds the Box Spoke application to your instance and includes the following modules.{#box-spoke__table_oqb_kf5_fpb__entry__2}

| Module | Description |
|-|-|
| Box Webhook Registry | Create and view the Box webhooks in ServiceNow. |
| Legal Hold Policies | View the list of available Box legal policies. |
| Retention Policies | View the list of available Box retention policies. |
[Table 1. Box module]

{#box-spoke__table_oqb_kf5_fpb}

## Box account requirements {#box-spoke__section_fgv_rxg_gfb}

The Box spoke requires creating a custom app on your Box account to generate OAuth 2.0 tokens. See [Create an OAuth application](https://www.servicenow.com/docs/SZwrHh7QbrJVUELPe0BxIQ#configure-box-account "Create a custom OAuth application from your Box account to enable OAuth 2.0 authentication with the Box spoke.").

## Connection and credential alias requirements {#box-spoke__section_plx_qxg_gfb}

Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information
profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.

This spoke uses the following alias records to authorize actions.  
{#box-spoke__table_nnk_g2h_gfb__entry__3}

| Connection \& Credential alias | Description | Connection alias requirements |
|-|-|-|
| Box | Connection to the Box Collaboration and File Management APIs. | * Connection type: HTTP * Connection URL: https://api.box.com {#box-spoke__ul_atz_rsl_kfb} |
| Box Upload | Connection to the Box upload service. | * Connection type: HTTP * Connection URL: https://upload.box.com {#box-spoke__ul_z2p_xsl_kfb} |
[ ]

{#box-spoke__table_nnk_g2h_gfb}

To use the spoke connection aliases, create an associated Connection record and an associated Credential record for each alias. For information about setting up the spoke, see
[Set up the Box spoke](https://www.servicenow.com/docs/SZwrHh7QbrJVUELPe0BxIQ#setup-box-spoke "Integrate your ServiceNow instance and the Box APIs to automate the Box spoke actions. For example, you can set up a flow that removes a file in your Box account. When you set up the Box spoke, this flow is automated.").

*[\>]: and then