Custom Function: Move_Job_to_other_Stage | Online Help | Qntrl

Custom Function: Move_Job_to_other_Stage

  • This custom function can be used to move a card to any stage in the blueprint automatically.

  • Cards can be moved to previous stages or upcoming stages. 

Business Scenario


Mark, the head of Marketing, reviews all the marketing articles in his organization. If Mark rejects an article, the card can automatically be moved back to any of the previous stages and assigned to the designated user using this custom function.  

Steps to configure the custom function

Before executing this custom function, you will have to configure the arguments and authorizate connections. Follow the below steps to configure the function. 

1. Configure the Arguments


First, configure  Argument Values for all the parameters used in the custom function. You can either specify a Custom Value or choose a Form Field from the dropdown. Form fields capture dynamic values from card fields corresponding to the custom function. 



  • jobID : Choose the  Card ID  Form Field here. You can also specify the ID of the card. This will be available in the card URL ( core.qntrl.com/blueprint/ <org-name>/<module>/<jobID>).

  • toStageName:  Specify the stage to move the card.


2. Provide authorization using Connections


Connections helps you authenticate the API call for specific scopes of  Qntrl  and other internal Zoho applications used in the custom function. 

    1.   Invoke Connections to authorize your Qntrl account.

    • Click the  +Connections button in  Custom Functions or navigate to Connections under Advanced.

    • Click  Create Connection in the top-right corner.

    • Choose  Zoho Oauth on the  Pick Your Service tab.

    • Enter a  Connection Name and choose the 'Orchestly.stage.READ' and 'Orchestly.job.ALL' scopes to connect. 

    2.   After successful authentication, include the connection details in the response block of the custom function.                    

           e.g: connection: "<Connection-name>"

Once the above steps are configured, you are all set to execute the custom function. 



Move_Job_to_other_Stage  is a part of Qntrl's pre-define custom functions available in Function Gallery. However, you can also write your own  custom functions  in Qntrl.