Go to full article


Overview

This API call allows a user to set the secret questions and answers on an account, or update questions and answers already set.

Business Rules

Once questions have been set on an account it is not possible to entirely remove all questions and answers outright.

If you do not set the VerifyPhonePassword element to false, you must provide the phone password on the account.

It is permitted to have one or two secret questions on the account, however this call not permit you to have no secret questions.

WSDL

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

Operation name


UpdateAccountContactChangeSecretQuestionsRequest



SOAP Example

API call using phone password
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:UpdateAccountContactChangeSecretQuestionsRequest>
         <urn:AccountID>3320188</urn:AccountID>
         <urn:ContactID>691771</urn:ContactID>
         <urn:SecretQuestionOne>Current Pet's name?</urn:SecretQuestionOne>
         <urn:SecretAnswerOne>Sweep</urn:SecretAnswerOne>
         <urn:SecretQuestionTwo>Place of Birth?</urn:SecretQuestionTwo>
         <urn:SecretAnswerTwo>Adelaide</urn:SecretAnswerTwo>
         <urn:PhonePassword>abc123</urn:PhonePassword>
      </urn:UpdateAccountContactChangeSecretQuestionsRequest>
   </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:UpdateAccountContactChangeSecretQuestionsResponse>
         <ns1:Result>Record updated Successfully</ns1:Result>
      </ns1:UpdateAccountContactChangeSecretQuestionsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
API call setting verify password to false
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"xmlns:urn="urn:emersion:api"> <soapenv:Header/> 
	<soapenv:Body> 				
		<urn:UpdateAccountContactChangeSecretQuestionsRequest> 	<urn:AccountID>3320188</urn:AccountID>
		<urn:ContactID>691771</urn:ContactID>
		<urn:SecretQuestionOne>Current Pet's name?</urn:SecretQuestionOne> <urn:SecretAnswerOne>Sweep</urn:SecretAnswerOne>
		<urn:SecretQuestionTwo>Place of Birth?</urn:SecretQuestionTwo> 
		<urn:SecretAnswerTwo>Adelaide</urn:SecretAnswerTwo> <urn:VerifyPhonePassword>false</urn:VerifyPhonePassword> 	</urn:UpdateAccountContactChangeSecretQuestionsRequest>
	</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:UpdateAccountContactChangeSecretQuestionsResponse>
         <ns1:Result>Record updated Successfully</ns1:Result>
      </ns1:UpdateAccountContactChangeSecretQuestionsResponse>
   </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
accountid
Account ID associated with the account you are trying to update.YesInt28

3320188


contactid
ID of the contact you are trying to updateYesInt28691771
secretquestionone
First secret question on the contact.YesStringN/A

The secret question must match at least one of the  following list

Place of birth?
What primary school did you go to?
Favourite holiday destination?
Name of your first boy or girlfriend?
Phone number from your childhood?
Favourite place to visit as a child?
First pet's name?
Favourite book?
Mother's maiden name?
First phone number?
Favourite football team?
Where did you spend your honeymoon?
Where did you meet your spouse?
Name of your favourite aunt?
Favourite food as a child?
Surname of your first boss?
First name of your favourite uncle?
Surname of a childhood friend?
Favourite sports team?
Current Pet's Name?
Surname of your best man?
Surname of your maid of honour?
Name of the street on which you grew up?
Surname of your favourite musician?
All-time favourite movie character?
Make of your first car?
Favourite author?
Name of your favourite uncle?
Oldest cousin's name?
Youngest child's nickname?
Oldest child's nickname?
Name of your oldest niece?
Name of your oldest nephew?
Name of your favourite teacher?
Favourite actor, musician, or artist?
Town of Birth?

secretansweroneThe answer to secret question oneYesString100
secretquestiontwoFirst secret question on the contact.NoStringN/ARefer to list of secret questions referenced in secret question 1.
secretanswertwoThe answer to secret question two.NoStrin100
phonepasswordThe phone password on the contact. This is required if verifyphonepassword is not set to flaseNobool100 abc123
verifyphonepasswordIndicates whether phone password will be required.  If this flag is set, you do not need to provide the phone password.Nobool

Enter:

false, 0, no

or;

true, 1, yes



Error Handling

Error MessageDescription
Neither Phone Password is provided nor VerifyPhonePassword is set to FalseIf you add this element to your call, set the element to true,1, or yes you must add the phone password element and provide the phone element.
An answer to question two is requiredYou cannot add a secret question and not provide an answer
At least one question - answer pair is requiredAs the message suggests, you must provide at least one question/answer pair.  It is not possible with this API call to remove all questions and answers from the account.
Provided phone password is incorrectAs the error suggests, provided phone password is not correct.