Connect AI agents to Jiminny

Scalekit connector

The Jiminny connector lets your AI agent act in each user's Jiminny account. Each user connects their own Jiminny access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 27 tools.

Tools: 27
What they doRead · write · destructive: 23 · 3 · 123 read3 write1 destructive
Users sign in with: Access token

What you can do

Review calls and meetings: list recorded activities by date and get participants, CRM data, and topic matches
Read conversation insights: fetch transcripts, AI summaries, action items, and questions asked during a call
Track call scoring: pull AI scorecards, automated call scores, and coaching feedback for reps over a date range
Upload recordings: send a call or meeting recording as a file or public URL for transcription and analysis
Monitor team engagement: see who listened to or commented on calls, and list team users and topic triggers
Manage webhooks: create, list, and delete webhook subscriptions, and preview sample payloads for each trigger

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
Set your credentials
Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Create the Jiminny connection
In AgentKit > Connections, create a Jiminny connection. The name you give it is the connection_name your code passes. See Configure connections.
Console steps with screenshots
Register your Jiminny API key with Scalekit so it can authenticate requests to Jiminny’s conversation intelligence API on your behalf. You’ll need an API key from your Jiminny organisation settings.

Only users with an Admin or Owner role in Jiminny can generate API keys. Your API key grants access to your organisation’s data — store it securely and never share it over unsecured channels like email.
1. Generate an API key in Jiminny
  - Sign in to Jiminny and navigate to Organisation Settings → General.
  - Scroll to the API Key section and click Generate API Key.
  - Click Copy to copy the key to your clipboard. Store it securely — you can regenerate it later, but doing so invalidates the previous key and breaks existing integrations.
2. Create a connection in Scalekit
  
  In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Jiminny and click Create.
3. Add a connected account
  
  Open the connection you just created and click the Connected Accounts tab → Add account. Fill in the required fields:
  - Your User’s ID — a unique identifier for the user in your system
  - Bearer Token — the API key you copied in step 1
  Click Save.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'jiminny'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Jiminny:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'jiminny_activities_list',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "jiminny"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Jiminny:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="jiminny_activities_list",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user opens the link once and enters their Jiminny credentials there. If your app already has a user's credentials, add the account from your backend instead, as the console steps above show. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

jiminny_action_items_getRetrieve the AI-generated action items for a given activity, returning a list of follow-up tasks identified from the conversation.Read-only
Get Action Items
Retrieve the AI-generated action items for a given activity, returning a list of follow-up tasks identified from the conversation.
Inputs
activityIdstringrequired
The UUID of the activity to retrieve action items for.
jiminny_activities_listRetrieve completed and processed call and meeting activities with optional date range, update date range, status, and page filters.Read-only
List Activities
Retrieve completed and processed call and meeting activities with optional date range, update date range, status, and page filters. The time range must be less than six months and you must provide either fromDate/toDate or updatedFrom.
Inputs
fromDatestring
Filter activities that occurred after this UTC date-time (e.g. 2021-10-01 00:00:00). Must be before toDate.
pageinteger
Page number to return (page size is 500 activities). Default is 1.
statusstring
Filter activities by status: in-progress, completed (for calls/meetings), received, sent, delivered (for SMS/Voice dialer).one of receivedsentdeliveredin-progresscompleted
toDatestring
Filter activities that occurred before this UTC date-time (e.g. 2021-11-01 00:00:00). Cannot be a future date.
updatedFromstring
Filter activities updated after this UTC date-time (e.g. 2021-11-01 00:00:00). Must be before updatedTo.
updatedTostring
Filter activities updated before this UTC date-time. Cannot be a future date. Defaults to current time.
jiminny_activity_getRetrieve a single completed and processed activity by its ID, including tracks, participants, transcription summary, topic triggers, and CRM data.Read-only
Get Activity
Retrieve a single completed and processed activity by its ID, including tracks, participants, transcription summary, topic triggers, and CRM data.
Inputs
activityIdstringrequired
The UUID of the activity to retrieve.
jiminny_ai_scorecard_getRetrieve the AI-generated scorecard results for a given activity, returning the conversation intelligence scoring breakdown.Read-only
Get AI Scorecard
Retrieve the AI-generated scorecard results for a given activity, returning the conversation intelligence scoring breakdown.
Inputs
activityIdstringrequired
The UUID of the activity to retrieve scorecard results for.
jiminny_ai_scorecards_listRetrieve a paginated list of AI scorecard results completed within a required date range.Read-only
List AI Scorecards
Retrieve a paginated list of AI scorecard results completed within a required date range. Filtered by the date scoring completed, not the call date.
Inputs
fromDatestringrequired
Return scorecards completed on or after this UTC date-time (e.g. 2024-10-01 00:00:00). Must be before toDate.
toDatestringrequired
Return scorecards completed on or before this UTC date-time (e.g. 2024-11-01 00:00:00). Must be after fromDate.
pageinteger
Page number to retrieve. Default is 1.
jiminny_automated_call_scoring_listRetrieve automated call scoring records with optional filters by user and date range, returning scores, activity types, and user details.Read-only
List Automated Call Scoring
Retrieve automated call scoring records with optional filters by user and date range, returning scores, activity types, and user details.
Inputs
fromDatestring
Filter scoring records created after this UTC date-time (e.g. 2021-10-01 00:00:00).
toDatestring
Filter scoring records created before this UTC date-time (e.g. 2021-11-01 00:00:00). Cannot be a future date.
userIdstring
Optional UUID of the user to filter automated call scoring results by.
jiminny_automated_report_download_getRetrieve a short-lived presigned download URL (expires after 15 minutes) for an artifact of an automated report's latest result.Read-only
Get Automated Report Download URL
Retrieve a short-lived presigned download URL (expires after 15 minutes) for an artifact of an automated report's latest result.
Inputs
reportIdstringrequired
The UUID of the automated report to download.
formatstring
Which artifact of the report to download.one of pdfaudiodefault pdf
jiminny_automated_report_getRetrieve a single automated report, including its latest result.Read-only
Get Automated Report
Retrieve a single automated report, including its latest result. Returns 404 for reports outside your organization, soft-deleted reports, or reports not shared with any team.
Inputs
reportIdstringrequired
The UUID of the automated report to retrieve.
jiminny_automated_report_status_getLightweight poll endpoint that returns the generation status of an automated report's latest result, without the full report payload.Read-only
Get Automated Report Status
Lightweight poll endpoint that returns the generation status of an automated report's latest result, without the full report payload.
Inputs
reportIdstringrequired
The UUID of the automated report to check.
jiminny_automated_reports_listRetrieve a paginated list of the authenticated organization's automated (exec) reports.Read-only
List Automated Reports
Retrieve a paginated list of the authenticated organization's automated (exec) reports. A report is only returned if it has been shared with at least one team; reports shared only with individuals, or not shared at all, are never returned.
Inputs
frequencystring
Filter by report frequency.one of weeklymonthlyquarterlyone_off
fromDatestring
Only return reports created on or after this UTC date-time.
pageinteger
Page number to return (page size is 100 reports). Default is 1.
reportTypearray
Filter by one or more report types.
toDatestring
Only return reports created on or before this UTC date-time.
jiminny_coaching_feedback_listRetrieve bulk coaching feedback records within a required date range, optionally filtered by coach or coachee, returning scores, activity IDs, and timestamps.Read-only
List Coaching Feedback
Retrieve bulk coaching feedback records within a required date range, optionally filtered by coach or coachee, returning scores, activity IDs, and timestamps.
Inputs
fromDatestringrequired
Filter coaching feedback records created after this UTC date-time (e.g. 2021-10-01 00:00:00). Must be before toDate.
toDatestringrequired
Filter coaching feedback records created before this UTC date-time (e.g. 2021-11-01 00:00:00). Cannot be a future date.
coacheeIdstring
Optional UUID of the coachee (sales rep) to filter coaching feedback by.
coachIdstring
Optional UUID of the coach (manager) to filter coaching feedback by.
jiminny_comments_listRetrieve activity comment records with optional filters by user and date range, returning comment IDs, activity IDs, user IDs, and creation timestamps.Read-only
List Comments
Retrieve activity comment records with optional filters by user and date range, returning comment IDs, activity IDs, user IDs, and creation timestamps.
Inputs
fromDatestring
Filter comments created after this UTC date-time (e.g. 2021-10-01 00:00:00). Must be before toDate.
toDatestring
Filter comments created before this UTC date-time (e.g. 2021-11-01 00:00:00). Cannot be a future date.
userIdstring
Optional UUID of the user to filter comments by.
jiminny_listens_listRetrieve listened (played) activity records within a date range, optionally filtered by user, showing who listened to which activities and when.Read-only
List Listens
Retrieve listened (played) activity records within a date range, optionally filtered by user, showing who listened to which activities and when.
Inputs
fromDatestringrequired
Filter listened activities that occurred after this UTC date-time (e.g. 2021-10-01 00:00:00). Must be before toDate.
toDatestringrequired
Filter listened activities that occurred before this UTC date-time (e.g. 2021-11-01 00:00:00). Cannot be a future date.
userIdstring
Optional UUID of the user to filter listened activities by.
jiminny_organization_getReturn the current authenticated Organization details including name, CRM integration, calendar type, and address.Read-only
Get Organization
Return the current authenticated Organization details including name, CRM integration, calendar type, and address.
Inputs
This tool takes no inputs.
jiminny_questions_getRetrieve questions detected in a specific activity, including their timestamps, speaker participant IDs, text, and whether they are engaging or insightful.Read-only
Get Questions
Retrieve questions detected in a specific activity, including their timestamps, speaker participant IDs, text, and whether they are engaging or insightful.
Inputs
activityIdstringrequired
The UUID of the activity to retrieve detected questions for.
jiminny_summary_getGet the AI-generated conversation summary for a given activity, returning the summary content text.Read-only
Get Summary
Get the AI-generated conversation summary for a given activity, returning the summary content text.
Inputs
activityIdstringrequired
The UUID of the activity to retrieve the summary for.
jiminny_test_tool_xyzTest.Read-only
Test Tool
Test.
Inputs
This tool takes no inputs.
jiminny_topic_triggers_listRetrieve all topic triggers configured for the authenticated team, returned as a hierarchy of themes, topics, and trigger keywords.Read-only
List Topic Triggers
Retrieve all topic triggers configured for the authenticated team, returned as a hierarchy of themes, topics, and trigger keywords.
Inputs
This tool takes no inputs.
jiminny_topic_triggers_matched_getRetrieve all topic triggers that were matched within a specific activity, including the theme, topic, trigger keyword, timestamps, and matched text excerpt.Read-only
Get Matched Topic Triggers
Retrieve all topic triggers that were matched within a specific activity, including the theme, topic, trigger keyword, timestamps, and matched text excerpt.
Inputs
activityIdstringrequired
The UUID of the activity to retrieve matched topic triggers for.
jiminny_transcript_getRetrieve transcription segments for a given activity, returning an array of timed speech segments with speaker participant IDs.Read-only
Get Transcription
Retrieve transcription segments for a given activity, returning an array of timed speech segments with speaker participant IDs.
Inputs
activityIdstringrequired
The UUID of the activity to retrieve the transcription for.
jiminny_users_listRetrieve all users belonging to the authenticated team, including their IDs, names, emails, statuses, team names, CRM IDs, and roles.Read-only
List Users
Retrieve all users belonging to the authenticated team, including their IDs, names, emails, statuses, team names, CRM IDs, and roles.
Inputs
This tool takes no inputs.
jiminny_webhook_sample_getRetrieve a sample webhook payload for a given trigger event type to understand the data structure that will be sent.Read-only
Get Webhook Sample Payload
Retrieve a sample webhook payload for a given trigger event type to understand the data structure that will be sent.
Inputs
triggerstringrequired
The webhook trigger event type to get a sample payload for.one of coaching_feedback_completedconversation_sharedconversation_exportedconversation_processedconversation_played
jiminny_webhooks_listRetrieve all webhook subscriptions registered for the authenticated organization, including their trigger, destination URL, and external ID.Read-only
List Webhooks
Retrieve all webhook subscriptions registered for the authenticated organization, including their trigger, destination URL, and external ID.
Inputs
This tool takes no inputs.
jiminny_activity_uploadUpload a call or meeting recording file to Jiminny for transcription and analysis, returning the new activity ID on success.Write
Upload Activity
Upload a call or meeting recording file to Jiminny for transcription and analysis, returning the new activity ID on success.
Inputs
hostUserEmailstringrequired
The email address of the host user. Must belong to the authenticated team.
languagestringrequired
The language locale of the activity (e.g. en_GB, en_US, fr_FR).
titlestringrequired
The title of the activity (max 250 characters).
accountIdstring
An optional CRM Account ID to associate with this activity (max 100 characters).
completedAtstring
The date the activity was completed (format: YYYY-MM-DD).
externalIdstring
An optional external identifier for this activity (max 191 characters). Must be unique per host user.
leadIdstring
An optional CRM Lead ID to associate with this activity (max 180 characters).
notifyForUploadCompletionByEmailboolean
Whether to notify the host user via email when the upload and processing is complete.
opportunityIdstring
An optional CRM Opportunity ID to associate with this activity (max 100 characters).
skipFullAnalysisboolean
Whether to skip the full AI analysis of the uploaded activity.
jiminny_webhook_createCreate a webhook subscription that sends event payloads to a destination URL when a specified trigger occurs in Jiminny.Write
Create Webhook
Create a webhook subscription that sends event payloads to a destination URL when a specified trigger occurs in Jiminny.
Inputs
triggerstringrequired
The event trigger for the webhook. One of: coaching_feedback_completed, conversation_shared, conversation_exported, conversation_processed, conversation_played.one of coaching_feedback_completedconversation_sharedconversation_exportedconversation_processedconversation_played
urlstringrequired
The destination URL to receive the webhook payload (max 191 characters).
external_idstring
An optional external identifier for the webhook (max 191 characters).
jiminny_zapier_activity_uploadUpload a call or meeting activity to Jiminny by providing a publicly accessible recording URL instead of a file upload, returning the new or existing activity ID.Write
Upload Activity via Recording URL
Upload a call or meeting activity to Jiminny by providing a publicly accessible recording URL instead of a file upload, returning the new or existing activity ID. If externalId is provided and already exists for the host user, the existing activity is returned instead of creating a duplicate.
Inputs
hostUserEmailstringrequired
The email address of the host user. Must belong to the authenticated team.
languagestringrequired
The language locale of the activity. Accepts BCP 47 format (e.g. en-US, en_US, en); bare language codes are expanded to the first known dialect.
recordingUrlstringrequired
A publicly accessible URL to the recording file (audio or video).
titlestringrequired
The title of the activity (max 250 characters).
accountIdstring
An optional CRM Account ID to associate with this activity (max 100 characters).
completedAtstring
The date and time the call was completed (ISO 8601).
externalIdstring
An optional external identifier for this activity (max 191 characters), used for idempotency. Must be unique per host user.
leadIdstring
An optional CRM Lead ID to associate with this activity (max 180 characters).
notifyForUploadCompletionByEmailboolean
Whether to notify the host user via email when processing is complete.
opportunityIdstring
An optional CRM Opportunity ID to associate with this activity (max 100 characters).
jiminny_webhook_deleteDelete an existing webhook subscription by its UUID.Destructive
Delete Webhook
Delete an existing webhook subscription by its UUID.
- Idempotent
Inputs
idstringrequired
UUID of the webhook to delete.

What you can do

Setup

Install the SDK

Set your credentials

Create the Jiminny connection

Generate an API key in Jiminny

Create a connection in Scalekit

Add a connected account

Authorize a user and make your first call

Tools

Call it

Returns

Get Action Items

Inputs

List Activities

Inputs

Get Activity

Inputs

Get AI Scorecard

Inputs

List AI Scorecards

Inputs

List Automated Call Scoring

Inputs

Get Automated Report Download URL

Inputs

Get Automated Report

Inputs

Get Automated Report Status

Inputs

List Automated Reports

Inputs

List Coaching Feedback

Inputs

List Comments

Inputs

List Listens

Inputs

Get Organization

Inputs

Get Questions

Inputs

Get Summary

Inputs

Test Tool

Inputs

List Topic Triggers

Inputs

Get Matched Topic Triggers

Inputs

Get Transcription

Inputs

List Users

Inputs

Get Webhook Sample Payload

Inputs

List Webhooks

Inputs

Upload Activity

Inputs

Create Webhook

Inputs

Upload Activity via Recording URL

Inputs

Delete Webhook

Inputs

Related: other CRM & Sales connectors