Inbound Webhooks Integration Overview

Applies to

Bridge by Smartsheet

With Inbound Webhooks, you can generate and expose webhook endpoints to trigger workflows or actions on Bridge.

Triggers

Workflow Triggers

A list of pre-set workflow triggers that can be used to run a Bridge workflow without needing to specify the request body or headers

With this method, you specify the Workflow and any pre-set State Values, and a Request URL will be generated. Any requests to this URL will start the specified workflow, passing any request body data to the workflow, available using the {{runtime}} handlebar reference.

Each trigger has a unique URI that contains an uid so we know what trigger has been requested.

Chat Triggers

A list of pre-set workflow triggers that can be used to run a Bridge workflow for a specified user and chat channel, without needing to specify the request body and headers.

With this method, you specify the Workflow, Chat Channel, User Email, and any pre-set State Values, and a Request URL will be generated. Any requests to this URL will start the specified workflow on the chat channel, passing any request body data to the workflow, available using the {{runtime}} handlebar reference.

Each trigger has a unique URI that contains an uid so we know what trigger has been requested.

Advanced Triggers

If you need to be more flexible with what workflows you trigger, and you have the ability to set the request body and headers, then you will be able to dynamic determine what workflows or chat workflows can be triggered using a single endpoint

Secret

When registering the extension, you can specify a secret that will be expected to be passed as the value for the Inbound-Webhook-Secret header that must be passed for any calls to the extension webhooks

If you do not specify a secret, a random UUID will be generated for you.

Workflow Request URI

This URI is unique to each workspace and will be generated when you set up the extension.

This URI is used when you want to make a structured request to run one or more Bridge workflows.

Chat Request URI

This URI is unique to each workspace and will be generated when you set up the extension.

This URI is used when you want to make a structured request to run one or more Bridge workflows on a chat channel for one or more users.