Go to full article


Overview

This call is used to immediately update properties against service, service subscription or service type map providing service subscription id.

WSDL

https://api.emersion.com.au/Services.wsdl

Operation name

UpdateServiceProperties



Business Rules

  • Service subscription must be at the bottom tier (i.e. at the end user account level)
  • Service subscription must be owned by caller account




SOAP Example


Request:  

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api" xmlns:urn1="urn:emersion:types">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:UpdateServiceProperties>
         <urn:ServiceSubscriptionID>4087634</urn:ServiceSubscriptionID>
         <urn:Properties>
            <!--Zero or more repetitions:-->
            <urn1:PropertyKeyValue>
               <urn1:Key>MW_DIRECT_API_KEY</urn1:Key>
               <urn1:Value>333333</urn1:Value>
            </urn1:PropertyKeyValue>
            <urn1:PropertyKeyValue>
               <urn1:Key>MW_DIRECT_API_PASSPHRASE</urn1:Key>
               <urn1:Value>777777</urn1:Value>
            </urn1:PropertyKeyValue>
         </urn:Properties>
      </urn:UpdateServiceProperties>
   </soapenv:Body>
</soapenv:Envelope>  


Response:  

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:emersion:api">
   <SOAP-ENV:Body>
      <ns1:UpdateServicePropertiesResponse/>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Field Descriptions

All field names are case sensitive. Check enumerated values in the descriptions to confirm capitalisation and spacing. See field types for additional information..

NameDescriptionRequired?Field Type

Character

limit

Values
ServiceSubscriptionID
ID of the service subscription, against which, the properties are updatedYesInteger

e.g. 100000

Properties

Yes


  PropertyKeyValue

1 or more repetitionsYes


    Key

Emersion property nameYesStringcase-insensitivee.g. MW_DIRECT_API_KEY
    ValueString to update as Emersion property valueYesString
e.g. 333333



Error Handling


Error MessageDescription
Service Subscription ID must be provided

Service Subscription ID must be integer

Service Subscription ID not found
When the ID is not found in Emersion database
Service Subscription ID must be the bottom service subscription

Service Subscription is not owned by the 
caller account