Skip to main content
Documentation
Documentation
Administrator Guide
Last Updated: 2026-03-13
Launch Orchestrations on Business Process Status Changes

Launch Orchestrations on Business Process Status Changes

  • On the Workday Developer Site, create an Extend app.
  • In your Workday tenant, create a business process.
You can configure a business process to automatically launch an orchestration when a user takes one of these actions:
  • Cancel
  • Rescind
  • Correct
  • Deny
This can help ensure data consistency between Workday and external systems. Example: A
Hire
 business process performs steps in Workday, then launches an orchestration to integrate with an external system that handles access provisioning. If the hire is rescinded, the business process launches a different orchestration that integrates with the external system to revoke the provisioned access.
These orchestrations must be based on the Workday Business Process template.
  1. On the Workday Developer Site, add an orchestration based on the Workday Business Process template to your Extend app.
    If your orchestration makes API calls, it must use ISU authentication.
  2. On the orchestration's
    Business Process Trigger
     step, configure input parameters to define the values the orchestration can receive from the business process.
  3. Add the steps that you want the orchestration to perform when the business process that calls it is canceled, rescinded, corrected, or denied.
  4. Deploy the application containing the orchestration to your tenant.
  5. In Workday, access the
    Edit Tenant Setup - Business Processes
     task. In the
    User to Perform Orchestration Launches
     field, specify an individual with the appropriate permissions to access fields and perform actions required by the orchestration.
  6. In Workday, from the related actions menu of the business process, select
    Business Process
    Configure Orchestrations
    .
  7. In the
    Configure Orchestrations
     task, click
    Add
     to begin pairing the business process status change with the orchestration.
  8. In the
    Action
     field, select the business process status change that launches the orchestration,
    Cancel
    ,
    Rescind
    ,
    Correct
    , or
    Deny
    .
  9. In the
    Orchestration
     field, select
    Create Orchestration Launch Configuration
    .
    Workday doesn't create orchestration launch configurations automatically. Your orchestration might have successfully deployed to the tenant, but you can't select it here until you create a launch configuration.
  10. In the
    Create Orchestration Launch Configuration
     task, provide a unique
    Name
     for the configuration and select the
    Orchestration
     that you deployed.
  11. In the
    Configurable Parameters
     section, Workday displays the input parameters you configured on the orchestration's
    Business Process Trigger
     step. Configure the values that you would like the business process to pass to the orchestration.
  12. Back in the
    Configure Orchestrations
     task, you can now select the orchestration launch configuration you created.
    You can additional pairings of business process status change and orchestration launch to cover other actions.
  13. (Optional) Click the new
    Create Condition Rule
     button to define a new rule directly within the grid.
    Workday evaluates these condition rules before it initiates an orchestration.
  14. (Optional) To view the status of an orchestration associated business process, use the
    Find Events
     task. Workday displays the orchestration's status on the
    Orchestrations
     tab.
    A business process-triggered orchestration is typically launched by the Workday scheduler within 15 minutes. There might be a longer delay in Mass Cancel or Mass Rescind scenarios.
    The time taken for the orchestration status to change from
    In Progress
     to
    Completed
     is solely dependent on the orchestration's processing.
  15. (Optional) When the orchestration's status changes from
    Queued for Launch
     to
    In Progress
    , a
    Relaunch
     option becomes available on the
    Event Canceled
    ,
    Event Rescinded
    ,
    Event Corrected
    , or
    Event Denied
     page. Click it to access the
    Relaunch Orchestration
     task, where you can adjust launch parameters, if necessary, before relaunch. When you relaunch an orchestration, Workday executes the workflow without re-evaluating the condition rules.
    The action page displays
    Completed
     status for the orchestration only if the initiating user has View permission for the event.
Concept: Workday Extend