Sorry, you need to enable JavaScript to visit this website.

7 Create Lead

Action

Using your clientID, clientSecret (which you obtained when you created an application) you will make a Post request using the endpoint and values below to create a lead.

Method POST
Endpoint https://b2b-api.nedbank.co.za/apimarket/b2b-sb/shortterminsurance/v1/lead
Request
Headers
Header Value Description
x-ibm-client-id <YOUR CLIENT ID> The client ID you received when creating the app on the portal.
x-ibm-client-secret <YOUR CLIENT SECRET> The client secret you received when creating the app on the portal.
Body JSON 
                                
{
  "referenceNumber": "REPLACE WITH RANDOM VALUE",
  "policyHolder": {
    "title": "REPLACE WITH VALUE FROM GET REFERENCE DATA STEP",
    "firstName": "Paul",
    "surname": "Lombard",
    "initials": "Mr",
    "iDType": "RSAIDENTITY",
    "iDNumber": "8712305678901",
    "dateOfBirth": "1987-12-30",
    "gender": "Male",
    "maritalStatus": "REPLACE WITH VALUE FROM GET REFERENCE DATA STEP",
    "communication": {
      "email": "LOMBARDPAINTERS@YAHOO.COM",
      "mobileNumber": "27123456789",
      "contactNumber": "27123456789",
      "address": {
        "line1": "24 BOTTERBLOM AVENUE",
        "line2": "cowley road",
        "city": "Johannesburg",
        "suburb": "GRASSY PARK",
        "province": "WESTERN CAPE",
        "postalCode": "07941"
      },
      "language": {
        "alert": "ENG",
        "contract": "ENG"
      },
      "preferredModeForAlert": "email"
    }
  },
  "scores": {
    "propensityToClaim": 800,
    "propensityToLapse": 800
  },
  "motors": [
    {
      "make": "TOYOTA",
      "model": "COROLLA",
      "make-and-model-with-variant": "TOYOTA COROLLA 2.0 XR CVT",
      "registrationNumber": "RAHULZN",
      "engine": {
        "size": 1595,
        "type": "Gasoline or Diesel"
    },
      "vinNumber": "ABC123456",
      "colour": "REPLACE WITH VALUE FROM GET REFERENCE DATA STEP",
      "year": 2012,
      "mmCode": "1",
      "vehicleBodyType": "REPLACE WITH VALUE FROM GET REFERENCE DATA STEP",
      "coverType": "Comprehensive",
      "insuredValue": {
        "value": 220600,
        "currency": "ZAR"
      },
      "useOfMotor": "private",
      "isPerformanceEnhanced": true,
      "parking": {
        "daytime": "Garaged",
        "overnight": "Garaged"
      },
      "basicExcess": {
        "value": REPLACE WITH VALUE FROM GET REFERENCE DATA STEP,
        "currency": "ZAR"
      },
      "voluntaryExcess": {
        "value": REPLACE WITH VALUE FROM GET REFERENCE DATA STEP,
        "currency": "ZAR"
      },
      "noOfClaimFreeYears": 7,
      "noOfClaimsInLastFiveYears": 1,
      "uninterruptedCoverDuration": 0,
      "riskAddress": {
        "line1": "3 Shady Avenue",
        "line2": "cowley road",
        "city": "Johannesburg",
        "suburb": "Westcliff",
        "province": "KwaZulu-Natal",
        "postalCode": "4092"
      },
      "hasComprehensiveMotorInsurance": false,
      "hasInsurance": true,
      "drivers": [
        {
          "driver": {
            "title": "REPLACE WITH VALUE FROM GET REFERENCE DATA STEP",
            "dateOfBirth": "1987-12-30",
            "gender": "Male",
            "maritalStatus": "REPLACE WITH VALUE FROM GET REFERENCE DATA STEP",
            "iDType": "RSAIDENTITY",
            "iDNumber": "8712305678901"
          },
          "driverType": "REGULAR",
          "driverRelation": "SELF",
          "isDriverLocal": true,
          "licenseCode": "SA",
          "licenseTypeCode": "REPLACE WITH VALUE FROM GET REFERENCE DATA STEP",
          "licenseIssued": "2021-01-30"
        }
      ]
    }
  ],
  "sourceOfLead": "REPLACE WITH ALPHANUMERIC VALUE FOR DEALER CODE",
  "currentInsurer": "REPLACE WITH CURRENT INSURER"
}

Response can be fetched in two formats depending on the configuration done as per TPP requirement.

Response JSON

Sample Response with status and quote details: 

                                                 
{
  "status": "SUCCESS",
  "referenceNumber": "668",
  "quote": {
    "quoteReferenceNumber": "271696506156129",
    "status": "SUCCESS",
    "product": "NEDBANK INSURANCE",
    "policyFee": {
      "value": 0,
      "currency": "ZAR"
    },
    "totalPremium": {
      "value": 1201.42,
      "currency": "ZAR"
    },
    "quoteItems": [
      {
        "type": "Motor",
        "items": [
          {
            "status": "SUCCESS",
            "itemreference": "1",
            "premium": {
              "value": 1199.4,
              "currency": "ZAR"
            },
            "sasria": {
              "value": 2.02,
              "currency": "ZAR"
            }
          }
        ]
      }
    ]
  }
}

Sample Response with only status details: 

                                                 
{
  "status": "SUCCESS",
  "referenceNumber": "668"
}
Prev step