---
sourceDocument: Australia API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/api-reference

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Insert related records

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

Release version: Australia  
Updated March 12, 2026  
![](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`:

And `u_comment_items` is created as a related list for `u_custom_comments`
* **[WSDL Schema with related records](https://servicenow-prod.fluidtopics.net/f2bS8oCbWd8NXbkB6pIKwQ)**   
  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://servicenow-prod.fluidtopics.net/5_ALeEveWmUKXQRt3ISWpg)**   
  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://servicenow-prod.fluidtopics.net/f2bS8oCbWd8NXbkB6pIKwQ "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://servicenow-prod.fluidtopics.net/5_ALeEveWmUKXQRt3ISWpg "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.")