createLead

Purpose:

You can use createLead method to create leads in Apptivo with generic fields provided by application.

Request URL:

https://api.apptivo.com/app/dao/v6/leads?a=save&leadData{LEAD_DATA}&apiKey=API_KEY&accessKey=ACCESS_KEY

Request Parameters:

Parameter Data Type Description
leadData* JSON Please see the sample request URL
apiKey* String Apptivo API Key
accessKey* String Apptivo Access Key

* – Mandatory parameter

Output:

This will return the details of the created lead with JSON format.

Sample Request URL:

https://api.apptivo.com/app/dao/v6/leads?a=save&leadData={"lastName":"Testlead","isUnsubscribed":"N","wayToContact":"Email","easyWayToContact":"EMAIL","leadStatus":"1","leadStatusMeaning":"New","leadSource":"1","leadSourceMeaning":"Cold Call","leadTypeId":null,"referredById":44479,"referredByName":"lead test","assigneeObjectRefId":44479,"assigneeObjectRefName":"lead test","assigneeObjectId":8,"description":"","labels":[],"phoneNumbers":[],"emailAddresses":[{"emailAddress":"testcreatelead@berijam.com","emailTypeCode":"BUSINESS","emailType":"Business","id":"cont_email_input"}],"addresses":[{"addressAttributeId":"address_section_attr_id","countryId":2,"addressTypeCode":"1","addressType":"Billing Address","addressLine1":"","addressLine2":"","city":"","state":"","stateCode":"","zipCode":"","county":"","country":"Albania","countryName":"Albania","countryCode":"AL","deliveryInstructions":null,"addressGroupName":""}],"currencyCode":"ALL","potentialAmountCurrencyCode":"ALL","annualRevenueCurrencyCode":"ALL","campaignId":null,"territoryId":null,"marketId":null,"segmentId":null,"segmentName":"","accountId":null,"employeeRangeId":null,"industry":null,"accounts":[],"lastContactedDate":null,"createdBy":null,"lastUpdatedBy":null,"customAttributes":[]}&apiKey=oRxYzRZRvOTH-cTPBPVPArJnVNW-6a8d8bf4-1c5f-4930-a5da-49f380afcd33&accessKey=3g806jxv5gq7Q62E