Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.keenpartner.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

​
Request

​
action
string
required
Must be "get_leads".
​
channel_id
uuid
required
The channel to retrieve leads from. Your company must have access to this channel.

​
Response

Returns a JSON array of lead objects ordered by created_at descending. Up to 100 leads are returned per request.
Custom properties defined on the channel appear as top-level keys on each lead, keyed by the property definition name (for example, "Deal size"). Use get_channels to retrieve the list of property definitions for a channel.
​
[]
array

​
Example

​
Request

curl -X POST https://data.keenpartner.com/functions/v1/keen-api \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "action": "get_leads",
    "channel_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'

​
Response

[
  {
    "id": "99887766-5544-3322-1100-aabbccddeeff",
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+45 12345678",
    "company_name": "Acme Inc",
    "source": "website",
    "referring_employee": "John Smith",
    "business_id": "biz-123",
    "notes": "Interested in premium plan",
    "created_at": "2026-04-21T10:00:00.000Z",
    "status": "New",
    "Deal size": "50000",
    "Region": "EMEA"
  }
]

​
Errors

StatusErrorCause
400"channel_id required"The channel_id field is missing.
401"Invalid API key"Missing or invalid X-Api-Key header.
403"Channel not accessible"Your company does not have access to this channel.