In this example we create a conversation and pass the Skill ID in the Payload in order to route the consumer conversation to the desired skill in LiveEngage.

Getting Started

  1. Retrieve your domain. Use the LivePerson Domain API to retrieve this information by providing the following service name:

    • asyncMessagingEnt
  2. Here are the API terms of use.

Create new conversation with skill routing

Request URI

Method URL
POST https://{domain}/api/account/{accountid}/messaging/consumer/conversation?v=3

Request Headers

Header Description
Authorization The AppJWT token (see details here)
X-LP-ON-BEHALF The ConsumerJWS token (see details here)

Example Request Body - JSON Payload

   "kind": "req",
   "id": "1,",
   "type": "userprofile.SetUserProfile",
   "body": {
     "authenticatedData": {
       "lp_sdes": [{
           "type": "ctmrinfo",
           "info": {
             "socialId": "1234567890",
             "ctype": "vip"
           "type": "personal",
           "personal": {
             "firstname": "John",
             "lastname": "Doe",
             "gender": "MALE"


Property Description Value/Example Type Mandatory Notes
ttrDefName Defines the urgency of the conversation "NORMAL" / "URGENT" / "PRIORITIZED" / null string false  
channelType Which channel type is used "MESSAGING" string false Always use MESSAGING
brandId {accountid} - LivePerson site ID "LivePerson" string true  
skillId Skill ID you would like to route the conversation string false use -1 as default to target all skills available