Tools: OnTime SOAP API

Defect plugins can be used to implement a deeper bug tracker integration and TestRail comes with a ready-to-use OnTime defect plugin.

The OnTime defect plugin discussed in this article uses OnTime's SOAP API, which we recommend for OnTime v12 or earlier. If you are using OnTime v13 or later, we recommend using our new OnTime REST plugin instead, which comes with more built-in functionality and is easier to set up.

To configure the defect plugin, select Administration > Integration and select OnTime in the Defect Plugin dropdown list. The next step is to configure all the necessary connection settings in the Configuration field. Project specific plugins and configuration settings can optionally be specified under Administration > Projects.

When the defect plugin has been configured, a new Push link is shown next to the Defects field in the Add Test Result dialog. Clicking the link will open a popup dialog that enables you to push a bug report to OnTime without leaving TestRail. Once the test result was added, hovering the mouse cursor over an defect ID will open a window with useful information and status details about the defect in OnTime.

OnTime Now (Hosted)

As mentioned above, we recommend using our new OnTime REST defect plugin for new OnTime versions instead, including OnTime Now as it comes with more built-in functionality and is easier to set up.

If you are using OnTime Now you can find your API token when you login to your Axosoft Store account and click the Settings button next to your Hosted instance. You will need to use the Security Guid value of the OnTime Sdk Settings box for the integration settings (the token value in TestRail's configuration settings).

Please note that you also need to use a slightly different address for the defect plugin connection settings. You can find the correct URL on the same page as mentioned above (the Sdk URL address in the table at the bottom of the page).

If your normal OnTime Now address is this:
Then your SDK address likely looks like this:

OnTime Installation

The TestRail defect plugin for OnTime requires that the OnTime SDK is installed and configured on your OnTime server. Please contact the Axosoft support if you have any questions about the SDK. We can also usually provide tips on how to install the SDK.


The OnTime defect plugin was built to work with a standard OnTime configuration. TestRail allows you to customize the integration to work with your own custom fields among other things. Please see the following articles for details on how to customize the integration: