Add a webhook to a basic scenario
Webhooks, also known as instant triggers, are a specific kind of trigger module that can start a scenario whenever a change is made, instead of on a given schedule.
In this example, you will add a webhook to start a scenario as soon as any requests have been submitted to a specific request queue. The scenario then converts those requests to a project.
This example modifies the scenario created in Create a basic scenario.
Access requirements
You must have the following access to use the functionality in this article:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
---|---|
ÃÛ¶¹ÊÓƵ Workfront package | Any |
ÃÛ¶¹ÊÓƵ Workfront license |
New: Standard Or Current: Work or higher |
ÃÛ¶¹ÊÓƵ Workfront Fusion license** |
Current: No Workfront Fusion license requirement. Or Legacy: Any |
Product |
New:
Or Current: Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion. |
For more detail about the information in this table, see Access requirements in documentation.
For information on ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses.
Prerequisites
You must create the scenario described in Create a basic scenario before following this procedure.
Add and configure the webhook
Add the webhook module
-
Open the scenario in the scenario editor.
-
Right click on the first module and select Delete module.
The module is deleted, leaving a blank placeholder.
-
Click the blank module, and select ÃÛ¶¹ÊÓƵ Workfront from the list of apps.
-
Select Watch Events.
-
Click Add next to the Webhook field.
-
in the Record Type field, select Issue, so the module will trigger for changes in issues.
-
In the State field, select New state. This is a required field that is used for the filter, which this example does not cover.
-
In the Record Origin field, select New Record Only. This allows the scenario to trigger when an issue is added, not when one is updated or deleted.
-
Click Save to save the module configuration.
Update the second module
- Open the scenario.
- Click the Convert object module to open it.
- In the Issue ID field, delete the black ID block. The block is black because the module it was mapped from is no longer available.
- Select the ID block under the first module (Watch Events) to map it to the second module.
- Click OK.
Test and activate
-
Click Run once in the lower-left corner of the scenario editor.
The scenario must be running to watch for the new request.
-
Go to the Workfront environment that Fusion is connecting to and add an issue.
The scenario should run.
-
Examine the output to ensure that the scenario ran as expected.
-
When you are satisfied that the scenario is working as expected, click the Scheduling toggle in the lower-left of the screen to On.
This activates the scenario.
-
In Workfront Fusion, click Save near the lower-left corner to save your progress on the scenario.