Inbound webhooks utility function

Applies to

Bridge by Smartsheet

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

The Inbound Webhook Utility is currently only compatible with JSON payload objects.

Triggers

Workflow triggers

Workflow triggers are a list of preset workflow triggers you can use to run a Bridge workflow. 

When you use workflow triggers, you won't need to specify the request body or headers. Just specify the workflow and any preset state values, and then a request URL will be generated. Any requests to this URL will start the specified workflow, passing any request body data to the workflow. The request data will be available using the {{runtime}} handlebar reference.

Each trigger has a unique URL that contains a UID, so we know what trigger has been requested.

This solution doesn’t support webhooks, which include a challenge request. This will require a new custom integration to be built. 

Advanced triggers

Advanced triggers let you determine what workflows to trigger using a single endpoint. 

Use advanced triggers if: 

  • You need to be more flexible with what workflows to trigger, and
  • You can set the request body and headers.

Secret

When registering the extension, you can specify a secret expected to be passed as the value for the Inbound-Webhook-Secret header. This Inbound-Webhook-Secret header is what should 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 URL

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

Use this URL when you want to make a structured request to run one or more Bridge workflows.