Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

v_table – Scoped, Global

The v_table API provides methods to add rows to a remote table through a scriptable object.

This API requires the Remote Tables plugin (com.glide.script.vtable) to be activated. For additional information, see Retrieving external data using remote tables and scripts.

Use the v_query scriptable object to query remote tables.

Parent Topic:Server API reference

v_table - addRow(Object row)

Adds rows to the remote table.

See also:

NameTypeDescription
rowObjectJavaScript object containing field name and value map in which the key is the field name, for example, `{number: "INC0001", sys_id: "a34"}`.
{ "<field name>": "value" }
row.<field value>StringRepresents the value of the selected field. Although no fields are mandatory, provide the sys\_id at a minimum.Example listing only sys\_id field and value: ``` { "sys_id": "" }
</td></tr></tbody>
</table>

<table id="table_vdd_bdj_nlb" class="returns"><thead><tr><th>

Type

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Boolean

</td><td>

Flag that indicates whether the row was added to the remote table.Valid values:

-   true: Success.
-   false: Row was not added.

</td></tr></tbody>
</table>

The following example shows how to use the [RESTMessageV2](c_RESTMessageV2API.md) API to create and execute the REST call to an external bank application. The script shows how to use the addRow\(\) method to store return results in a remote table.
(function executeQuery (v_table, v_query) { // Parameters needed in the request body of the REST endpoint var requestBody = { 'financial_account':v_query.getParameter('financial_account') }; // Instantiate the RESTMessageV2 object var request = new sn_ws.RESTMessageV2(); // Set the HTTP method as "GET" request.setHttpMethod('get'); // URL of the endpoint on the bank application request.setEndpoint('https:///api/getTransactionDetails'); // Request body as a string request.setRequestBody(JSON.stringify(requestBody)); // Call the REST endpoint var response = request.execute(); // Get the response body var responseBody = response.getBody(); // Parse the response body into an object var responseObj = JSON.parse(responseBody); // Store the response body into a virtual table v_table.addRow({ sys_id: gs.generateGUID(), amount: responseObj.amount, description: responseObj.description, posting_date: responseObj.posting_date, transaction_date: responseObj.transaction_date }); }) (v_table, v_query); ```

sndocs is an independent community mirror and is not affiliated with or endorsed by ServiceNow.

ServiceNow, the ServiceNow logo, Now, and other ServiceNow marks are trademarks and/or registered trademarks of ServiceNow, Inc., in the United States and/or other countries. Other company and product names may be trademarks of the respective companies with which they are associated.

© 2026 ServiceNow, Inc. All rights reserved.

Documentation content is redistributed under the Apache License 2.0 from the ServiceNowDocs repository.