--- parser: v2 author_name: Chaitanya Priya Puvvada author_profile: https://github.com/chaitanya-priya-puvvada auto_validation: true time: 10 tags: [ tutorial>beginner, software-product>sap-business-technology-platform, tutorial>free-tier] primary_tag: software-product>sap-build-process-automation slug: spa-run-process-api-trigger canonical_url: https://developers.sap.com/tutorials/spa-run-process-api-trigger --- # Test an API Trigger for a Business Process Run API trigger for the Business Process. ## Prerequisites - Complete [Create an API trigger for the Process ](spa-create-process-api-trigger) - Complete [Create Destination to Trigger Process From any Service](spa-create-service-instance-destination) ## You will learn - How to discover APIs in SAP Business Accelerator Hub - How to test APIs in SAP Business Accelerator Hub - How to test an API trigger of a business process - How to start the business process from other services --- ### View an API trigger for the process Once you have successfully deployed the business process with an API trigger, you can view the API trigger in the **Overview** section under the tab **Triggers**. ![Trigger](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/viewTrigger1.png) 1. To view the context of the workflow API, navigate to the Lobby by clicking on the SAP logo. ![Lobby](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/goToLobby1.png) 2. Choose **Control Tower** > **Environments**. ![Environments](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/lobbyTower1.png) 3. Choose the environment in which the project is deployed. ![Environment](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/public1.png) 3. You can view the trigger in the **Triggers** tab. >If there are a lot of projects and triggers, you can view only yours by selecting your project in the project filter. ![Trigger](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/trigger1.png) 2. Click **View** for your trigger. ![View](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/trigger2.png) You will see the details of the API: the URL, the required payload and more. ![Trigger details](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/trigger3.png) >We will trigger the process with the tools in SAP Build Process Automation and not call the API directly. ### Trigger the process Again, generally you will trigger the process via an API. For more information the API, you can explore the [SAP Business Accelerator Hub](https://api.sap.com/package/SAPProcessAutomation/all) and the SAP Build Process Automation APIs, specifically, the Workflow package. ![Process and Workflow](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/5.1.png) And even more specific, the **workflow-instances** API call. ![Try out API](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/6.png) BUT ... we will NOT call the API but trigger the process through the tools of SAP Build Process Automation. 1. Go to the Control Tower, open the **Environments** tile, and then open the **Public** environment. ![Open Public](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/test1.png) 2. Select the **Process and Workflows** tab, then filter the list by your project, and find your process. ![Find process](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/test2.png) 3. With your process selected, click **Start New Instance**. In the dialog, delete everything and replace with the following: ```JavaScript { "salesorderdetails": { "orderNumber": "156789", "orderAmount": 40000, "customerName": "ABC Widgets", "orderDate": "2025-11-23", "shippingCountry": "Germany", "expectedDeliveryDate": "2025-12-25" } } ``` Click **Start New Instance and Close**. ![Start instance](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/test3.png) If all goes well, you should get a confirmation. ![Confirmation](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/test4.png) ### Monitor the triggered process in Home Page Let's see what we you have wrought. 1. In the home page of SAP Build, click **Monitoring**, and then select the **Process and Workflow Instances** tile. ![Open monitoring](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/monitor1.png) 2. Find the process you triggered by filtering by your project. ![Find project](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/monitor2.png) 3. Click on the process you started, and you will see: - **General information**, like when the process instance was started, by whom, the process definition ID it is based on, status, and more. - **Logs**, which show what steps were started and completed, and additional information about each one. For example, for an approval task, you can see who has been assigned the task. - **Context**, all the information that has passed through the instance, such as the input parameters passed in, any data retrieved via actions inside the process, the custom variables, and more. ![Instance information](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-run-process-api-trigger/monitor3.png)