3-7. Building a Workflow from Scratch

This page explains how to build a workflow from scratch by freely combining triggers and actions. This approach differs from using a template. It covers every step through to a “dry run,” which lets you verify the workflow before you publish it to production.

​

Use Cases

​

Available Triggers and Actions

A workflow built from scratch has a simple design. Start with a trigger, then add the actions you want to run one by one, from top to bottom. This lets you build an automation sequence intuitively.

​

Setup Steps

1. Go to Automation > click [Create Automation], then select [Create New] from the dialog.
2. In the “Builder” screen, click “1. Select Event”.
3. On the “Add Node” screen, select any trigger to display a detailed settings sidebar on the right side of the screen. Configure the trigger’s conditions and filters. For setup steps for each trigger, see the following links.
   • New employee added
   • Departed employee removed
   • Scheduled job
   • Webhook
   • Device field change
   
4. Select a node (+), then choose any action on the “Add Node” screen. A detailed settings sidebar appears on the right side of the screen. Configure the conditions there. For setup steps for each action, see the following links.
   • Data Mapping
   • Identity
   • Device
   • HTTP Request
   • Provisioning / Deprovisioning
   • Message (Notification)
   If you configure a Provisioning / Deprovisioning action, you must place a “Data Mapping” node in the step right before it.If the following screen appears, click [Add Data Mapping] and configure “Data Mapping” in the panel on the right.
   
5. Repeat these steps to add any other actions you need.
6. Once all checks in the “Builder” turn green, click Dry Run or [Publish].
7. The “Confirm Workflow Automation Settings” screen appears. Enter an automation name and click [Publish]. Note: You cannot reuse a name that is already registered for the automation name.
8. When “Workflow has been published” is displayed, click [OK].

​

Data Mapping

Select “Data Mapping” in the “Builder” screen to see a list of standard identity fields and your custom identity fields. Click [Auto-fill from Sample Payload] to automatically infer each field based on the keys received during the test. Matching priority is exact match, then prefix or suffix match.

​

Identity

In the “Builder” screen, under “Identity”, perform the following actions on the target user.

​

Service Selection (Parallel Execution)

1. Under “Parallel Execution”, click [+ Add Another Service] to add the services you want to configure in the workflow.
2. Select the service shown under “Provisioning” or “Deprovisioning”. The displayed services are those preconfigured (mapped). If you configure multiple services in the workflow, turn on “Multiple Selection”.
3. On the “Parallel Execution” screen, click a selected service to display the “Settings” panel on the right. Select “Service Settings - Workspace Name” from the dropdown. To configure multiple services, click [+ Add Another Service].

​

Device

On the “Device Settings” screen, select the action: “Delete Device / Unassign Device / Update Device”.

​

Notification

1. Under “Notification”, click [+ Add Another Notification].
2. On the “Message” screen, select the notification method “Slack/Email”. If you want to set up multiple notifications, turn on “Multiple Selection”. For Slack setup steps, see Notification Method “Slack” Setup Instructions.
3. On the “Notification” screen, click the selected message to display the “Settings” panel on the right.

​

HTTP Request

In “4. HTTP Request”, if a callback to an external API is needed, configure the method (POST, etc.) and endpoint URL. Configure the sender to send Webhooks in the following format.

​

Dry Run

Before publishing the workflow, run a test from [Dry Run].

1. Click [Dry Run] to display the “Dry Run” screen. Review the content, then click [Start Dry Run].
2. In the results list, each step lights up in real time as it runs. Review the content, then click [Rerun] or [Publish].
   If you select “Real User”, the run affects real data. In that case, the run happens against production data instead of a simulation.To avoid affecting real employee accounts or production data, always select “Mock User”.
   
3. Once the test completes, the result appears in a banner at the top of the screen. A results list for each step also appears. If a mock user (test account) was created, choose [Delete] or [Keep]. If the test succeeds, click [Publish]. If the test fails, fix the issue and run the test again.

​

Troubleshooting

​

FAQ

​

Q. Can I combine actions in ways that aren’t covered by a template?

A. Yes. Starting from any trigger, use “Add Node” to add actions. You can set up steps in any order or combination that fits your needs.

​

Q. Can I run actions in parallel?

A. Not currently. Parallel execution and branching are template-only features. When you build a workflow from scratch, it always forms a single linear chain that runs from top to bottom.

​

Q. Does a dry run affect real data?

A. If you select “Real User”, the run affects real data. In that case, the run happens against production data instead of a simulation. To avoid affecting real employee accounts or production data, always select “Mock User”.

​

Q. What happens to the mock user created for a dry run after the test?

A. After the test finishes, you can choose to [Delete] or [Keep] the mock user created during the dry run. [Delete] is selected by default, so the test data is removed immediately.

​

Q. Why don’t I see the “Real User / Mock User” choice for a New Hire dry run?

A. Testing onboarding always requires a new account, so the system automatically creates a mock user every time. Because of this, you don’t need to select a target user.

​

Q. Can I run a workflow dry run more than once?

A. Yes, you can run it multiple times before publishing. This requires that all nodes are configured correctly and the workflow isn’t archived. You can repeat the test from the header’s [Dry Run] or from [Rerun] on the “Dry Run” screen.

​

Q. What happens in production if I publish while some dry run steps have failed?

A. If you click [Publish] while an error remains, the workflow keeps failing in production until you fix the error. Proceed with caution.

​

Q. Can I edit or pause a workflow after creating it?

A. Yes. Click the workflow you want to change from the workflow list, then edit it from the “Builder” tab. To pause a workflow, turn off the toggle switch in the “Status” column of the workflow list to [Pause Workflow].