Skip to main content

Marketplace Workflow Triggers in Stack

Marketplace Workflow Triggers in Stack allow you to create custom triggers that push data from your application or API into a workflow. These triggers are part of Stack's Premium Triggers & Actions and incur charges per execution.

Table of Contents​

Prerequisites​

Note: Ensure that the workflows.readonly scope is enabled to activate actions and triggers.

Creating a Trigger​

  1. Name: Enter a descriptive name for your trigger.
  2. Key: Provide a unique identifier for this trigger. This key is used within the workflow and cannot be changed later. Example: {{mycustomtrigger.data.name}}

Trigger Information​

  • Icon: Choose an icon for your trigger. This icon will appear in the workflow.
  • Name: Specify a custom name for the trigger.
  • Key: A unique identifier used within the workflow. Example: {{trigger_a.custom_variable}}
  • Short Description: Briefly explain what your trigger does.
  • Summary: Provide detailed information to help users understand the purpose and benefits of using this trigger.

Trigger Configuration​

Trigger Data​

Enter a valid JSON structure as a sample payload that will be sent to the trigger. This data is used to configure filters and custom variables.

Manage Filters​

Add filters using sample trigger data to customize workflow trigger configurations.

  • Create New Filter:
    • Name: Enter the filter name.
    • Type: Choose from String, Select, Multiple Select, or Dynamic.
    • Required: Indicate if this filter is mandatory.
    • Reference: Select a reference key from the sample Trigger Data.
    • Alters Dynamic Filter: Enable to trigger/re-trigger dynamic filters in the UI.

Filter Types​

  • String: Define a string field.
  • Select: Define a select field with options.
  • Multiple Select: Define a multiselect field with options.
  • Dynamic: Build custom filters using an API call.

Managing Custom Variables​

Add custom variables using trigger data for workflow use.

  • Add Custom Variable:
    • Name: Enter the label name.
    • Reference: Select a reference key from the sample trigger data.

Subscription URL​

Collect trigger configuration details via an API endpoint.

  • URL (POST): Enter the endpoint URL to receive trigger configuration data.
  • Headers: Add necessary headers for the API call.

Submitting for Review​

Once you've updated the trigger information and configuration, submit the trigger version for review. It will initially be in a draft state. After approval, the version will be published live.

Creating a New Version​

To create a new version of a trigger:

  • Click + New Version. This action creates a new draft version with prefilled data from the last published version.

Deleting a Trigger​

Deleting a trigger is permanent and cannot be undone. Once deleted, the trigger is removed from the Marketplace App and Workflow Trigger list. If the trigger is part of any workflow, its execution will be skipped.

  • Confirmation: Enter the trigger name to confirm deletion.

Executing Workflows Without Contact​

Workflows can operate without contact data, allowing you to send any payload data via Marketplace Triggers. This feature supports actions like Custom Webhook, Google Sheet, Slack, ChatGPT, and other internal tools without requiring contact information.

If needed, you can use the Create/Update or Find Contact actions to incorporate contact data into the workflow.

Example: Send order data to a trigger, add the order information to a Google Sheet, categorize based on order value, and send a Slack notification. Retrieve contact data using the Find Contact action if necessary.