---
sourceDocument: Yokohama API Reference
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Insert related records using SOAP

# Insert related records using SOAP {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Support is available for inserting hierarchical data into tables or web service
import set tables. The hierarchical data in the Insert API is automatically mapped to
related records of the targeted table.

## Before you begin

Role required: admin

## Procedure

Create and set the property glide.web_service.hierarchical to true.  
The client of the API can also override this value by invoking the SOAP web service with the URL parameter hierarchical=true.

## Example

For example, when a related list is created for the incident table called
`u_custom_comments`:  
Figure 1. Hierarchical Incident

And `u_comment_items` is created as a related list for
`u_custom_comments`:  
Figure 2. Hierarchical Custom Comments
* **[WSDL Schema with related records](https://www.servicenow.com/docs/yNTsyyJBMe41xhr5qTGZTA)**   
  When a WSDL for the target Incident table is requested with an additional parameter of hierarchical=true, the WSDL schema for the Insert function will reflect available related records that may participate in the hierarchical data payload.
* **[Hierarchical SOAP Message](https://www.servicenow.com/docs/5tTL5P9zThELkdoK4K4y2g)**   
  When the SOAP message is constructed from the hierarchical web service described by the WSDL and invoked, it will create the `incident`, `u_custom_comments`, and `u_comment_items` records.

**Related reference**   

* [WSDL Schema with related records](https://www.servicenow.com/docs/yNTsyyJBMe41xhr5qTGZTA "When a WSDL for the target Incident table is requested with an additional parameter of hierarchical=true, the WSDL schema for the Insert function will reflect available related records that may participate in the hierarchical data payload.")
* [Hierarchical SOAP Message](https://www.servicenow.com/docs/5tTL5P9zThELkdoK4K4y2g "When the SOAP message is constructed from the hierarchical web service described by the WSDL and invoked, it will create the incident, u_custom_comments, and u_comment_items records.")