Create New Lead

---

Endpoint Description

This endpoint makes a request to finloup to register a new Lead.

POST /merchant/api/leads/ 

Request

REQUEST PARAMETERS	TYPE	DESCRIPTION
consumer (Required)	Consumer Object	Refer to Consumer Object
merchant (Required)	UUID4	The Merchant ID.
order (Required)	Order Object	Refer to Order Object
language (Required)	String	Customer language. Applicable values “el” or “en”.

Response

RESPONSE PARAMETERS	TYPE	EXPANDABLE	EXAMPLE	DESCRIPTION
redirect_url	URL		https://app.finloup.com/?lead_id=841ex7uDsXn5DxBoCKgpe13	URL to redirect consumer to finloup service and start a user flow
lead_id	UUID4		391b5883-b08b-4ffa-98e7-4e18b528f7ck	unique identifier of the user’s flow

---

Sample Request & Responses

POST https://app.finloup.com/merchant/api/leads/

{
   "consumer":{
      "first_name":"name",
      "last_name":"surname",
      "mobile_phone":"6912345678",
      "email":"name.surname@example.com",
      "address":{
         "street_name":"13 Western Gateway, Marmara Apartments,",
         "street_name_2":"",
         "city":"London",
         "post_code":"E16 1AJ",
         "country":"GB",
         "state":"Attica"
      },
      "logged_in":false,
      "birth_date":"2019"
   },
   "merchant":{
      "id":"00a4eb27-a037-4fac-8e85-22560392c12e"
   },
   "order":{
      "total":"100.0",
      "currency":"EUR",
      "date_created":"2021-06-05T12:49:54+00:00",
      "order_id":179473,
      "shipping_total":"19.72",
      "products":[
         {
            "name":"Super Dry T-Shirt",
            "description":"",
            "short_description":"",
            "sku":"LSTN",
            "price":"88",
            "quantity":1,
            "product_id":178375,
            "variation_id":178375,
            "categories":[
               "home",
               "Jewelry",
               "Luna",
               "Necklaces"
            ],
            "attributes":[
               {
                  "name":"Color",
                  "value":"Red"
               },
               {
                  "name":"Size",
                  "value":"L"
               }
            ]
         }
      ]
   },
   "language":"el"
}

Status: 200 OK

{
   "redirect_url":"https://app.finloup.com/?lead_id=o5dkdZzf76WhXgN1q4ba14",
   "lead_id":"b2bfa008-2f66-4720-a9e1-5aca8178e02z"
}