---
sourceDocument: Brazil Telecommunications, Media, and Technology
sourceDocumentLink: https://www.servicenow.com/docs/r/telecom-media-technology

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Telecommunications, Media, and Technology

ft:clusterId :

    - telmt

bundleId :

    - telmt

workflow :

    - Customer and Industry


---

# Test run

# Test run in Service Test Management {#ariaid-title1}

Release version: Brazil  
Updated October 23, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
A test run is one execution of a published test definition that validates service behavior. Create test runs from a workspace, through the subflow, or from an external system using the TMF 653 API.

very test run belongs to a test group run, so a test run can't exist on its own.

You can create a test run in three ways:

From a workspace
:   From a task or case in a workspace, by running diagnostics. When you start a test group run, the system
    creates a test run in the Draft state for each test definition, that you select, and its test measures and test characteristics. For more information, see [Test group run in Service Test Management](https://www.servicenow.com/docs/igrio9Ez_w1t5l0t2rztZA "A test group run captures one execution of a published test group and provides a structured record of test runs, measures, and characteristics.").

From the Automated test run creation tool subflow
:   The subflow creates a test run in the Draft state for a test definition within a test group run. The test run takes the
    name of the test definition and is described it as "Automated test run for" followed by the name of the definition. It also sets the start time to the current time.

From an external system
: An external system creates and updates the test run through the TMF 653 API that Customer Service Problem Management provides. For more information, see [Related Customer Service Problem Management information](https://www.servicenow.com/docs/FrjRqiis0DsPvFpIx1ePNw "Find the Service Test Management features that are described in the Customer Service Problem Management documentation.").  
Note:  
A test run can reference only a published test definition.

For more information about how the test runs are executed, see [Test run execution](https://www.servicenow.com/docs/4PU4roaxPDkmlA2mhoMbGQ "When a test run is triggered, the system sends a request to the external system through a spoke, records the response, and calculates the result. An external system can also run the test and report back through the Service Test Management Open API.").

## Automated test run creation tool {#test-run-stm__how-test-runs-are-created-subflow}

The Automated test run creation tool subflow creates a test run for a test definition within a test group run. The subflow can:

* Run a separate flow that creates test characteristics.
* Wait for user input.
* Wait for the test run to complete, with an optional timeout.

{#test-run-stm__ul_b3h_jjf_blc}

The subflow creates the test run in the Draft state, and it returns the test run that it creates. For its inputs, see [Flows, subflows, and actions installed](https://www.servicenow.com/docs/2IPfvMKK6tDhJxvsmZEEDA "Find the flows, subflows, custom actions, events, and clean-up rules that Service Test Management installs to run tests in the background."). To use it, set the execution type of a test group to Automated and select a flow that calls the subflow. See [Create a test group](https://www.servicenow.com/docs/E9yCzwdx3NcF8SguFSWkCg "Create a test group to group related service tests, such as speed and ping tests, to streamline diagnostics for specific service types or product models in Service Test Management.").
**Related concepts**   

* [Test group run and test run states](https://www.servicenow.com/docs/1XuFun8e4f1uGJI4Qt_u1g "Test group runs and test runs move through system-controlled states. The state determines what the system does next, what an external system can update, and when records are deleted.")
* [Service Test Management automation framework](https://www.servicenow.com/docs/2W5Dv_R8dQGXdbTyPEtq8Q "Service Test Management uses flows and subflows to run tests in the background. Events, a spoke selector, and templates start and extend them. You can add your own flows and extension points to customize the behavior.")
* [Test definitions in Service Test Management](https://www.servicenow.com/docs/t4STlHAHnKqPu1DgzNFPWQ "A test definition specifies the parameters, metrics, and threshold rules for a service test. Use test definitions to identify the root cause of service problems across service types, product models, and inventory.")