Skip to content
Notis

Set the Carbone API version by webhook

Let an external process request the Carbone API version your later report workflows should use.

Trigger

Webhook received

Notis starts this workflow when an external tool or custom backend sends an HTTP request.

Action

Set Carbone API Version

Tool to set the carbone api version to be used for subsequent requests. use before rendering or managing templates to ensure correct version is applied.

Why this helps

Coordinating API version changes across automated document workflows can add a manual setup step.

  • Start the version setting workflow with an HTTP request.
  • Set the Carbone API version for subsequent requests.
  • Reduce manual coordination when changing workflow configuration.

Setup

Build it in a few focused steps.

  • 1Connect Carbone once in the Notis portal.
  • 2Create an automation in Automations, New Automation, or tell Notis what to do from any channel.
  • 3In one instruction, specify the Carbone API version to set when the webhook is received.
  • 4Choose a webhook as the trigger and select where run reports should go.
  • 5Test by sending one real HTTP request and review the run report.

Questions about this workflow

Does the webhook itself set the version?

The webhook starts the automation. Notis uses the instruction to run Carbone's Set Carbone API Version action.

Can this generate a report too?

This workflow sets the API version. Use a separate report generation workflow for rendering documents.

What should the request contain?

Provide the information your instruction needs to determine the version. Do not rely on a version value that is absent from the request or instruction.

When this happens · Trigger

Do this · Action

Supported Triggers and Actions

Notis builds workflows that link Box to Carbone. A trigger fires from one place; an action lands in another.

Box triggers

Carbone actions

Recurring trigger

Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.

TriggerScheduled

Delete Carbone Template

Tool to delete a template from the carbone server. use after confirming you have the correct template id.

ActionInstant

Webhook trigger

Notis starts this workflow when an external tool or custom backend sends an HTTP request.

TriggerInstant

Download Template

Tool to download a template from carbone by template id. use when you need to retrieve the original template file.

ActionInstant

Collaboration Details Changed

Triggers when a collaboration's details change (e.g., role, status, expiration). This trigger monitors a specific collaboration and detects when any meaningful field changes, such as role, status, expiration date, access type, or acknowledgment status.

TriggerPolling

Generate Carbone Report

Tool to generate a carbone report from a template and json data. use when you need to render documents in various formats.

ActionInstant

Comment Changed

Triggers when a comment's content or details change in Box. This trigger monitors a specific Box comment and detects when any meaningful field changes, such as message text edits, tagged message changes, or modification timestamp updates.

TriggerPolling

Generate Template ID

Tool to generate a unique template id for a new template. use when you need the template identifier before uploading.

ActionInstant

New File Comment Added

Triggers when a new comment is added to a file in Box. This trigger monitors a specific Box file and fires when new comments are detected.

TriggerPolling

Get Carbone Server Status

Tool to retrieve the current status and health of the carbone server. use before generating reports to ensure the service is operational.

ActionInstant

File Metadata Changed

Triggers when a file's metadata or properties change in Box. This trigger monitors a specific Box file and fires when changes are detected in key fields like name, description, size, modification time, parent folder, or status.

TriggerPolling

Set Carbone API Version

Tool to set the carbone api version to be used for subsequent requests. use before rendering or managing templates to ensure correct version is applied.

ActionInstant

File Shared Link Changed

Triggers when a file's shared link settings change in Box. This trigger monitors a specific Box file's shared link and fires when changes are detected in the shared link configuration, such as access level, permissions, password protection, expiration date, or vanity URL.

TriggerPolling

Upload a template

Tool to upload a template to the carbone server. use when you need to add or replace a template by providing its content.

ActionInstant

New File Version Uploaded

Triggers when a new file version is uploaded to a file in Box. This trigger monitors a specific Box file and fires when new versions are detected.

TriggerPolling

Connect any two apps with Notis in the middle.

Box and Carbone, or any other combination from 1,000+ integrations.

When this happens · Trigger

Do this · Action

Save your first hour today.

7-day trial of any paid plan, with 20$ of usage included.
No card. Works with personal or business Carbone.