POST
/
api
/
v1
/
session
{
    "scenario_code": "default"
    "language": "fr-FR"
    "external_id": 123, // i.e your customer_ref
    "input_data": {
        "firstname": "Customer firstname",
        "lastname": "Customer lastname",
        "phone": "+352521000000",
        "birthdate": "YYYY-MM-DD",
        "address": "TestAddress",
        "zip": "TestZip",
        "country": "TestCountry",
        "city": "TestCity"
    }
}

{
  "session_id": "d897374f-6458-4781-b4ec-cfb192297d6a",
  "customer_reference": "123",
  "start_date": 1516975975
}

​
Request

Content-Type: application/json

ParameterTypeDescription
scenario_codestringRequired. Scenario to be used for this session
languagestringRequired. Language to be used for this session, must be enabled in the scenario
external_idstringOptional. Your customer reference, if not defined an orphan session will be created
input_dataobjectOptional. Customer data to be used for this session, see ‘input_data’ reference

​
Response

Content-Type: application/json

ParameterTypeDescription
session_idstringSession ID
customer_referencestringCustomer reference
start_dateintSession start date in unix timestamp format
{
    "scenario_code": "default"
    "language": "fr-FR"
    "external_id": 123, // i.e your customer_ref
    "input_data": {
        "firstname": "Customer firstname",
        "lastname": "Customer lastname",
        "phone": "+352521000000",
        "birthdate": "YYYY-MM-DD",
        "address": "TestAddress",
        "zip": "TestZip",
        "country": "TestCountry",
        "city": "TestCity"
    }
}

{
  "session_id": "d897374f-6458-4781-b4ec-cfb192297d6a",
  "customer_reference": "123",
  "start_date": 1516975975
}