---
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


---

# Hierarchical SOAP Message

# Hierarchical SOAP Message {#ariaid-title1}

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

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.

## Endpoint URL

https://instance.service-now.com/incident.do?SOAP\&hierarchical=true

## Request

    <soapenv:Envelope
        xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
        xmlns:inc="http://www.service-now.com/incident">
       <soapenv:Header/>
       <soapenv:Body>
          <inc:insert>
             <short_description>test hierarchical</short_description>
             <u_custom_comments>
                <u_comment>comment 1</u_comment>
                <u_comment_type>travel</u_comment_type>
                <u_comment_items>
                   <u_name>name 1</u_name>
                   <u_value>value 1</u_value>
                </u_comment_items>
             </u_custom_comments>
          </inc:insert>
       </soapenv:Body>
    </soapenv:Envelope>

## Reponse

    <soapenv:Envelope 
        xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
        xmlns:inc="http://www.service-now.com/incident">
       <soapenv:Header/>
       <soapenv:Body>
          <insertResponse>
             <sys_id>8422ebe7c0a8006e7d23848c2dc8ba47</sys_id>
             <number>INC0010001</number>
          </insertResponse>
       </soapenv:Body>
    </soapenv:Envelope>