Skip to main content
GET
/
v1
/
employees
List employees
curl --request GET \
  --url https://api.yo-lead.com/v1/employees \
  --header 'X-YoLead-Key: <api-key>' \
  --header 'X-YoLead-Signature: <api-key>' \
  --header 'X-YoLead-Timestamp: <api-key>'
{
  "data": [
    {
      "id": "64f000000000000000000001",
      "firstName": "Alex",
      "lastName": "Smith",
      "channels": [
        "64f000000000000000000010"
      ],
      "position": "Operator",
      "access": "default",
      "status": "active",
      "createdAt": "2026-05-08T12:00:00.000Z"
    }
  ]
}

Authorizations

​
X-YoLead-Key
string
header
required

Public API key generated in the YoLead UI.

​
X-YoLead-Timestamp
string
header
required

Unix timestamp in milliseconds. Requests must be signed within a 5-minute window.

​
X-YoLead-Signature
string
header
required

Hex HMAC-SHA256 signature over <timestamp>.<raw_body> using the API secret.

Response

Employees list.

​
data
object[]
required