Developers
The Koachly sales coaching API
REST API, outbound webhooks and native integrations — three ways to connect your stack to Koachly call data.
Integration options
Three ways to integrate
Pull data
REST API
Read calls, contacts and scores from any backend. Authenticate with a Bearer token from Settings → API Keys.
Push events
Outbound Webhooks
Koachly POSTs a JSON payload to your URL when a call is scored, completed or a contact is created.
No code
Native Integrations
Connect HubSpot, Salesforce, Slack and more from Settings → Connections. No API key needed.
REST API
Endpoints
Base URL: https://koachly.ai — all endpoints require HTTPS.
Authentication
Authorization: Bearer sk_live_…Obtain your key in Settings → API Keys. Never expose secret keys in client-side code.
| Method | Path | Description | Scope |
|---|---|---|---|
| GET | /api/v1/calls | List all calls for the authenticated user. | calls:read |
| GET | /api/v1/calls/:id | Retrieve transcript, score and tips for a single call. | calls:read |
| GET | /api/v1/contacts | List contacts synced from your connected CRM. | contacts:read |
| GET | /api/v1/me | Returns profile and plan info for the current key holder. | profile:read |
Example
curl -H "Authorization: Bearer sk_live_..." \
https://koachly.ai/api/v1/callsRate limits
100 requests per hour per API key. Responses include X-RateLimit-Remaining and X-RateLimit-Reset headers.
Outbound Webhooks
Events
Koachly sends a POST request to your endpoint URL within seconds of each event.
call.scored
A call score (0–100) has been computed.
{
"event": "call.scored",
"call_id": "cl_1a2b3c",
"score": 74,
"scored_at": "2026-10-21T09:14:00Z"
}call.completed
A live call session ends and the transcript is ready.
{
"event": "call.completed",
"call_id": "cl_1a2b3c",
"duration_s": 1843,
"completed_at": "2026-10-21T09:12:00Z"
}contact.created
A new contact is created or synced from a CRM.
{
"event": "contact.created",
"contact_id": "co_9x8y7z",
"name": "Alex Rivera",
"created_at": "2026-10-21T08:00:00Z"
}Configure your webhook URL in Settings → Webhooks. Koachly signs every request with a shared secret — verify the X-Koachly-Signature header before processing.
FAQ
Developer questions
Ready to build?
Get your API key in Settings. Start free — no credit card.
Free account. No credit card.