Call Now! (855) 248-4016

AmVenture SOAP API

Use AmVenture SOAP API to create a Lead

Base URL

All URLs referenced in the documentation for the SOAP API have the following base: 

The AmVenture SOAP API is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.

Sample request (Java)

config.setServiceEndpoint(""); config.setSessionId("00Df4000001...");


All requests are protected with OAuth 2.0 authentication and require an Access Token. Due to the lifetime of an Acccess Token, a user would have to constantly log in to retreive a new Access Token. AmVenture provides users an "refresh token"* which can be used to obtain an access token prior to calling the SOAP API; for calls to the SOAP API pass access token to sessionid in the SOAP Header.

*A long-lived token that may be used to obtain a fresh access token on expiry of the access token in this response. This value is a secret. You should treat it like the user’s password and use appropriate measures to protect it.

Access Token

The client application obtains a new access token by POSTing a request to*, with the payload of the form:


Parameters Description
grant_type Set this to refresh_token.
client_id Your application's client identifier.
client_secret Your application's client secret.
refresh_token The refresh token provided in the previous authorization.


Use the AmVenture API (SOAP) to create a Lead.

1. Download WSDL here

2. Call SOAP API

On receipt of the access token, the client can call the SOAP API, send a response to the user, and carry on servicing requests until the new access token expires.


Parameters Type Description Required
VCC__c Text(255) AmTrust will provide value Y
Company Text(255) The leads company Y
FirstName Text(40) The leads first name Y
LastName Text(80) The leads last name Y
Street Text Area The lead company's address line1 N
City Text(40) The leads company's city N
State Picklist The lead company's state
(complete spelling; "New York")
Postalcode Text The lead company's postal code N
Country Text The lead company's country
(complete spelling; "United States")
Title Text(128) The leads job title N
Email Email The leads business email address Y
Phone Phone The leads business phone Y
MobilePhone Phone The leads mobile phone N
Insurance_Number__c Text(100)   N
Years In Business c Picklist The leads company's years business N
NumberOfEmployees Number(8,0) The leads company's number employees N
VRNA__SICCode__c. Text (15) The lead company's sic code N
Annual_Revenue__c Text(255) The lead company's annual revenue
Example: $100,000.00 - $500,000.00
IP_Address__c Text(50) The ip address captured from the lead N
Google_Tracking_ID__c Text(255) The google id captured for the lead N
Business_Type__c Picklist The business type pertaining to the lead. N
Legal_Entity__c Text(255) The legal entity of the business pertaining to the lead. N
Payroll__c Currency(18,0) The business payroll pertaining to the lead. N
Effective_Date__c Date The date which the policy will take effect. N
UTM_Source__c Text(255) URL variable used to identify the source. N
UTM_Medium__c Text(255) URL variable used to identify the channel. N
UTM_Campaign__c Text(255) URL variable used to identify the campaign. N
UTM_Content__c Text(255) URL variable used to identify the content. N
UTM_Term__c Text(255) URL variable used to identify the audience. N
TFN__c Phone The toll free number that the party called. N
ANI__c Phone The caller ID that is passed. N
Vendor_Tracking_ID__c Text(255) The specific ID that the vendor assigned to a specific lead. N

Sample (Java)

import com.sforce.soap.partner.*; import com.sforce.soap.partner.PartnerConnection; import; import; import com.sforce.soap.partner.sobject.*; public class Main { static PartnerConnection connection; public static void main(String[] args) { String result = null; ConnectorConfig config = new ConnectorConfig(); config.setServiceEndpoint(""); config.setSessionId("00Df4000001QUSU!AQ......."); try { connection = Connector.newConnection(config); PartnerConnection partnerConnection = null; partnerConnection = new PartnerConnection(config); // display some current settings System.out.println("Auth EndPoint:"+config.getAuthEndpoint()); System.out.println("Service EndPoint:"+config.getServiceEndpoint()); SObject lead = new com.sforce.soap.partner.sobject.SObject(); lead.setType("Lead"); lead.setField("VCC__C", "100001"); lead.setField("Company", "ACME"); lead.setField("FirstName", "John"); lead.setField("LastName", "Doe"); // Make a create call and pass it the array of sObjects SaveResult[] results = partnerConnection.create(new SObject[] { lead}); // Iterate through the results list // and write the ID of the new sObject // or the errors if the object creation failed. // In this case, we only have one result // since we created one contact. for (int j = 0; j < results.length; j++) { if (results[j].isSuccess()) { result = results[j].getId(); System.out.println( "\nA contact was created with an ID of: " + result ); } else { // There were errors during the create call, // go through the errors array and write // them to the console for (int i = 0; i < results[j].getErrors().length; i++) { System.out.println("Errors were found on item " + j); System.out.println(results[j].getErrors()[i]); } } } } catch (ConnectionException e1) { e1.printStackTrace(); }