Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

Box

Secure content management and collaboration

CategoryContent And Files
AuthenticationOAuth 2.0
Version0.2.0
Published scopes3 published scopes
Last updatedSeptember 19, 2026

Overview

Box

This CDK catalogue package is pinned to @activepieces/piece-box@0.2.0 and declares 1 declared action and 3 declared triggers. Its definition is derived from the exact reviewed Activepieces source.

Provider runtime verification is recorded separately when an approved test connection is exercised; this catalogue entry does not claim that verification.

Technical guide

Technical reference

  • Package: @activepieces/piece-box@0.2.0
  • Exact artifact digest: sha256:74838fa80aed9c5685d92b4be928423eeb231d6899bfbe42da92adfd0d61bf9b
  • Source: the exact reviewed Activepieces source
  • Authentication, action and trigger schemas are taken from the exact pinned package.

Capability summary

AuthenticationOAuth 2.0
Supported objects4
Supported actions1
Triggers3

Authentication

Authentication method: OAuth 2.0

Required scopes

manage_webhookroot_readonlyroot_readwrite

Authentication profiles

connection · oauth2

OAuth scopes: manage_webhook, root_readonly, root_readwrite

Supported objects

ObjectReadWriteNotes
Custom API Call Yes No
New File Yes No Trigger contract validated offline; live event delivery is tracked separately.
New Folder Yes No Trigger contract validated offline; live event delivery is tracked separately.
New Comment Yes No Trigger contract validated offline; live event delivery is tracked separately.

Supported actions

Custom API Call · Read

Make a custom API call to a specific endpoint

custom_api_call · Risk: low · Retry: safe

Inputs

  • url · object · Required
  • method · string · Required
  • headers · object · Optional, Authorization headers are injected automatically from your connection.
  • queryParams · object · Optional, Appended to the URL as ?key=value.
  • body_type · string · Optional
  • body · object · Optional
  • response_is_binary · boolean · Optional, Enable for files like PDFs, images, etc.
  • failsafe · boolean · Optional, On a failed request, output the error instead of failing the step.
  • timeout · number · Optional, Seconds to wait for a response. Empty: up to the flow limit (10 min).
  • followRedirects · boolean · Optional, Follow 3xx redirects instead of returning them as the response.

Triggers

New File · Webhook

Triggers when a file is uploaded

Inputs

  • folder · string
New Folder · Webhook

Triggers when a folder is created

Inputs

  • folder · string
New Comment · Webhook

Triggers when a comment is created

Inputs

  • id · string
  • type · string

Setup

Setup

Create a tenant connection only in the consuming Studio instance when this connector is made available there. Credentials remain in that tenant's Vault-backed connection and are not stored in CDK package metadata.

Limitations

The package has passed deterministic offline package-load and contract validation. No provider credentials, provider API call or live webhook delivery is represented by this release state.

github.com