Assign lead

Endpoint

PUT /engage/v1/leads/{team-member-id}/{lead-id}/assign

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 assign 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 team member and lead are provided in the URL.

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

Responses

Success — 201 Created

The lead was assigned to the requested team member.

{
  "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 team-member-id = 42 and lead-id = 1234. Replace YOUR_TOKEN with the business access token.

cURL

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

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

JavaScript — fetch

const response = await fetch(
  "https://client-api.e-so.in/engage/v1/leads/42/1234/assign",
  {
    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/42/1234/assign"
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.