The Webhook Runner test step can be used to test async REST APIs. This is done by using it to receive async responses from a web server in return for REST requests made to that server.
You can add a Webhook Runner test step from your functional tests, by using one of the below methods.
Click
in the navigator and select the Webhook Runner test step.
– or –
In the test case editor, select the Webhook Runner test step from the toolbar.
You can edit a Webhook Runner to specify the path on which the Webhook accepts async requests from a web server. The requests received on that path will be processed by Webhook.
To edit a Webhook Runner, click on its name within your Test Case Navigation panel. The editor will open and you can edit its path.
![]() |
You can also edit the Webhook Runner’s Path by using Property Expansions to specify a dynamic path that gets defined at runtime.
You can specify the property expansion manually, or by using the Get Data Dialog visual tool. To use the visual tool, click on the "..." button displayed at the right end of the Path field.
![]() |
You can run a Webhook Runner as a standard test step, as part of a Test Case. To do this, click on the corresponding Run button or the Run menu item.
The Webhook Runner can be run in different Test Cases, in Sequence or Parallel alongside those Test Cases.
![]() |
This capability is under development and will be included in one of the next ReadyAPI versions.
You can configure your Webhook Runner by accessing the ReadyAPI Preferences screen.
Within ReadyAPI Preferences, select the Webhook server item. Once selected, the corresponding configuration panel will open on the screen. You can configure the Server port and Webhook step timeout
Server Port - The port on which the Webhook Runner is listening for a request/response from a server.
Webhook Step Timeout - The time (in seconds) for which the Webhook is waiting for a request/response. During this waiting time, the execution of your Test Case is blocked on the Webhook Runner test step.
Once that time has elapsed, the Webhook Runner step will stop waiting and will pass execution to the next step in your Test Case.
![]() |
The Webhook Runner’s activity is logged in the ReadyAPI logging panel so that you can trace it.
![]() |