Please note that this API relates to LivePersons legacy chat product which receives limited support and will be deprecated in the future.

It is recommended to build future integrations on top of LivePersons Messaging Platform SDK instead.


Method URL
POST https://{domain}/api/account/{accountid}/agentSession?v=1&NC=true

Request Headers

Header Description
Authorization Bearer {bearer-from-login}
Content-Type application/json
Accept application/json


The body media type must have one of the following formats:

  • XML
  • JSON


For backwards compatibility purposes, you must include the following request body:

  "loginData": ""


Elements in the response

Name Description Type/Value Notes
agentSessionId The ID of the agent session string Found in the @href element

Response Codes

Code Response
201 Created

Response example for JSON:

 "agentSessionLocation": {
   "link": {
     "@href": "https://{domain}/api/account/{accountId}/agentSession/{agentSession Id}",
     "@rel": "location"