SOAP API - CreateContact

CreateContact( username, contactTypeName, firstName, lastName, title, company ) : Integer

Since: EngageIP v25.2

Creates a new contact for a user and returns the ID of the new contact.

Parameters:

  • username (String) - The name of the user in which to add a new contact.  An exception will be thrown if the username does not exist.

  • contactTypeName (String)  - Name of the type of contact to be added.  An exception will be thrown if the contact type name does not exist.

  • firstName (String) - The contact's first name

  • lastName (String) - The contact's last name

  • title (String) - The title associated with the contact

  • company (String) - The name of the company the contact works for

Returns:

The new contact ID

Possible Exceptions:

  • INVALID USERNAME

  • INVALID CONTACT TYPE NAME


SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /adminportal/webservice.asmx HTTP/1.1 Host: demo.logisense.com Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Header> <AuthHeader xmlns="Logisense_EngageIP"> <Username>string</Username> <Password>string</Password> </AuthHeader> </soap12:Header> <soap12:Body> <CreateContact xmlns="Logisense_EngageIP"> <username>string</username> <contactTypeName>string</contactTypeName> <firstname>string</firstname> <lastname>string</lastname> <title>string</title> <company>string</company> </CreateContact> </soap12:Body> </soap12:Envelope>

 

HTTP/1.1 200 OK Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Body> <CreateContactResponse xmlns="Logisense_EngageIP"> <CreateContactResult>int</CreateContactResult> </CreateContactResponse> </soap12:Body> </soap12:Envelope>


SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /adminportal/webservice.asmx HTTP/1.1 Host: demo.logisense.com Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "Logisense_EngageIP/CreateContact" <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <AuthHeader xmlns="Logisense_EngageIP"> <Username>string</Username> <Password>string</Password> </AuthHeader> </soap:Header> <soap:Body> <CreateContact xmlns="Logisense_EngageIP"> <username>string</username> <contactTypeName>string</contactTypeName> <firstname>string</firstname> <lastname>string</lastname> <title>string</title> <company>string</company> </CreateContact> </soap:Body> </soap:Envelope>