Unassign Lead

Endpoint

PUT /engage/v1/leads/{lead-id}/unassign

Authentication

Every request must include a business access token in one of the following headers. If both headers are sent, Authorization is used.

• Tokens are issued per business and can unassign only leads belonging to that business.
• A missing, invalid, or expired token returns 401 Unauthorized.
• Keep the token secret. Do not expose it in client-side code or public repositories. Rotate it immediately if it may have been leaked.

Path parameters

Request

Headers

Body

No request body is required. The lead is identified in the URL.

PUT /engage/v1/leads/1234/unassign HTTP/1.1
Host: client-api.e-so.in
Authorization: Bearer YOUR_TOKEN

Responses

Success — 201 Created

The lead was successfully unassigned.

{
  "status": 201,
  "success": true,
  "message": "Operation Successful."
}

Error responses

Errors use the following JSON structure:

{
  "status": 404,
  "success": false,
  "message": "Lead not found!"
}

Behavior

Code examples

These examples use lead-id = 1234. Replace YOUR_TOKEN with the business access token.

cURL

curl -X PUT "https://client-api.e-so.in/engage/v1/leads/1234/unassign" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Alternative header
curl -X PUT "https://client-api.e-so.in/engage/v1/leads/1234/unassign" \
  -H "auth-key: YOUR_TOKEN"

JavaScript — fetch

const leadId = 1234;
const response = await fetch(
  `https://client-api.e-so.in/engage/v1/leads/${leadId}/unassign`,
  {
    method: "PUT",
    headers: { Authorization: "Bearer YOUR_TOKEN" },
  },
);

const body = await response.json();
if (!response.ok) {
  console.error(`Error ${body.status}: ${body.message}`);
} else {
  console.log(body.message);
}

Python — requests

import requests

url = "https://client-api.e-so.in/engage/v1/leads/1234/unassign"
headers = {"Authorization": "Bearer YOUR_TOKEN"}
response = requests.put(url, headers=headers)

if response.status_code == 201:
    print(response.json()["message"])
elif response.status_code == 401:
    print("Authentication failed — check your token.")
elif response.status_code == 404:
    print("Lead not found — check the lead ID and business.")
else:
    print(f"Unexpected error {response.status_code}: {response.text}")

Related endpoints

Support

If an integration issue continues, contact EasySocial Support and include the full request URL, the status and message from the response, and the request timestamp in UTC. Never include the access-token value.