Box Spoke

Move attachments to Box where they can be managed as shared documents.

Request apps on the Store

Visit the ServiceNow Store 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.

Integration Hub subscription

This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.

Spoke version

Box spoke v3.7.0 is the latest version.

Supported versions

API version v2.

Spoke requirements

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 Profile > Preferences > Display.

  

• In your Box account, select the required language by navigating to Account Settings > Account > General Options.

  

Spoke flows

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:

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.

Spoke actions

The Box spoke provides actions to automate Box tasks when events occur in ServiceNow. Available actions include:

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.
	Extract Metadata Freeform	Sends a context‑aware request to supported AI models and extracts metadata as structured key‑value pairs.
	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.
	Look up Box Hub Items Stream	Retrieves all items associated with the specified Box Hub.
	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.
	Attach Box File to Record	Copies a file from Box and attaches it to the specified ServiceNow record.
	Lookup File ID	Retrieves the ID of the specified file in Box.
	Move Owned Item	Moves all items owned by the specified user in Box to the specified folder.
	Remove File	Removes the specified file from Box.
	Search Content Stream	Searches for files, folders, web links, and shared files across the user's content or across the entire enterprise.
	Upload File	Uploads the specified file to Box.
	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
	Create Shared Link	Create a direct and read-only link to a file or folder in Box.
	Look up Folder Collaborators By ID	Retrieves all the collaborators associated to the specified folder ID.
	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.
	Delete Folder	Deletes the specified folder in Box.
	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.
	Look up Folder Information	Retrieves details for the specified folder.
	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.
	Delete Group	Deletes the specified group in Box.
	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.
	Create Legal Hold Policy	Creates a legal hold policy.
	Look up All Legal Hold Policies Stream	Retrieves a list of legal hold policies of an enterprise.
	Look up Legal Hold Policy Assignment by ID	Retrieves a legal hold policy assignment for the specified ID.
	Look up Legal Hold Policy Assignments Stream	Retrieves a list of items assigned to a legal hold policy.
	Look up Legal Hold Policy by ID	Retrieves a legal hold policy for the specified ID.
	Remove Legal Hold Policy	Deletes an existing legal hold policy.
	Unassign Legal Hold Policy	Removes the assignment of an item to a legal hold.
	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.
	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.
	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.
	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.
	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.
	Create Retention Policy	Creates a retention policy.
	Look up Retention Policies	Retrieves all the retention policies of an enterprise.
	Look up Retention Policy Assignment By ID	Retrieves the retention policy with the specified ID.
	Look up Retention Policy Assignments Stream	Returns a list of all retention policy assignments associated with a specified retention policy.
	Look up Retention Policy by ID	Retrieves the retention policy with the specified ID.
	Update Retention Policy	Updates a retention policy.
User Management	Add User to Group	Adds the specified user to the specified group in Box.
	Create User	Creates a user account in Box.
	Delete User	Deletes the specified user in Box.
	Disable User	Sets the status of the specified user in Box to inactive.
	Enable User	sets the status of the specified user in Box to active.
	Lookup User ID	Retrieves the ID of the specified user in Box.
	Update User	Updates the specified user in Box with the specified role changes.
Webhook Management	Create Webhook	Creates a webhook.
	Look up Webhook By ID	Retrieves the webhook with the specified ID.
	Look up Webhooks Stream	Retrieves all the defined webhooks for the specified application.
	Remove Webhook	Removes a webhook.
	Update Webhook	Updates a webhook.

Available AI agents

Install Now Assist for Integration Hub and start using the available AI agents. For more information, see Now Assist for Integration Hub.

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 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 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 for more information about creating a clone.
• See Now Assist AI agents for information about AI agents.

Available AI agents include:

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.

There might be AI agents installed with the Now Assist application that are not used in agentic workflows. To learn how to see all agents that are available to you, see Find AI agents.

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

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:

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

For information about setting up the triggers for the Box spoke, see Set up triggers for the Box spoke. For more information about inbound integration, see Conditional and event-driven inbound integration.

Spoke user roles

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 module

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.

Table 1. Box module

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.

Box account requirements

The Box spoke requires creating a custom app on your Box account to generate OAuth 2.0 tokens. See Create an OAuth application.

Connection and credential alias requirements

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.

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 Upload	Connection to the Box upload service.	Connection type: HTTP Connection URL: https://upload.box.com

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.