> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Callingly

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

**Authentication:** Bearer Token
**Categories:** CRM & Sales, Communication
**Tools:** 40: 20 read, 16 write, 4 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CALLINGLY)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Callingly connection

   In **AgentKit > Connections**, create a Callingly connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'callingly'
   const identifier = 'user_123'

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

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'callingly_agents_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "callingly"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Callingly:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="callingly_agents_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Callingly credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'callingly_agent_schedule_get',
  toolInput: {
    agent_id: 123,
  },
  connector: 'callingly',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="callingly_agent_schedule_get",
    tool_input={
        "agent_id": 123,
    },
    connection_name="callingly",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `callingly_agent_schedule_get`

Get Agent Schedule · Read-only

Get an agent's weekly availability schedule.
Returns one entry per weekday with is_available and time ranges.
Use callingly_agent_schedule_get before callingly_agent_schedule_update.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `agent_id` (`integer`, required): Agent ID, from callingly_agents_list. Example: 123

Example input: `{"agent_id":123}`

### `callingly_agents_list`

List Agents · Read-only

List the users (agents) who take calls.
Returns each agent's ID, name, phone, do-not-disturb flag, priority, time zone and availability.
Use callingly_agents_list to find agent IDs for teams. Use callingly_agent_schedule_get for working hours.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1

Example input: `{}`

### `callingly_call_get`

Get Call · Read-only

Get one call by ID.
Returns the call's direction, status, lead status, duration, recording URL, transcript, agent, lead and team.
Use callingly_call_get for a call's details and recording. Use callingly_calls_list to find calls.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `call_id` (`integer`, required): Call ID, from callingly_calls_list. Example: 1234

Example input: `{"call_id":1234}`

### `callingly_calls_list`

List Calls · Read-only

List calls in a date range, optionally for one team.
Returns a page of calls with direction, status, duration, recording URL, lead and agent.
Use callingly_calls_list to review call activity. Use callingly_call_get for one call's transcript.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
- `end` (`string`, optional): End date, YYYY-MM-DD. Example: 2026-11-16
- `limit` (`integer`, optional): Results per page, default 10, at most 100. Example: 25
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `start` (`string`, optional): Start date, YYYY-MM-DD. Example: 2026-11-01
- `team_id` (`integer`, optional): Only calls for this team. Example: 123

Example input: `{}`

### `callingly_clients_list`

List Clients · Read-only

List agency client accounts (agency partners only).
Returns each client's ID, name, email and billed users and numbers.
Use callingly_clients_list to get an account_id for acting on a client's account.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `callingly_conversation_get`

Get Conversation · Read-only

Get one SMS conversation by ID.
Returns the conversation with unread count, last message, lead and number.
Use callingly_conversation_get for a thread's summary. Use callingly_conversation_messages_list for its messages.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conversation_id` (`integer`, required): Conversation ID, from callingly_conversations_list. Example: 42

Example input: `{"conversation_id":42}`

### `callingly_conversation_messages_list`

List Conversation Messages · Read-only

List the messages in one SMS conversation, newest first.
Returns a page of messages with body, direction and time.
Use callingly_conversation_messages_list to read a thread before replying with callingly_sms_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `conversation_id` (`integer`, required): Conversation ID, from callingly_conversations_list. Example: 42
- `limit` (`integer`, optional): Results per page, default 30, at most 100. Example: 25
- `page` (`integer`, optional): Page number, starting at 1. Example: 1

Example input: `{"conversation_id":42}`

### `callingly_conversations_list`

List Conversations · Read-only

List SMS conversations (one thread per lead and number), most recently active first.
Returns a page of conversations with unread count, last message, lead and number.
Use callingly_conversations_list to find threads with unread replies. Use callingly_conversation_messages_list to read one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
- `lead_id` (`integer`, optional): Only conversations with this lead. Example: 1
- `limit` (`integer`, optional): Results per page, default 10, at most 100. Example: 25
- `number_id` (`integer`, optional): Only conversations on this phone number. Example: 7
- `page` (`integer`, optional): Page number, starting at 1. Example: 1

Example input: `{}`

### `callingly_integration_routing_get`

Get Integration Routing · Read-only

Get the routing rules that decide which team a lead from an integration goes to.
Returns the default team and sequence and the ordered rules with field, operator, value, conditions and action.
Use callingly_integration_routing_get before callingly_integration_routing_update. Needs an owner or admin API key.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `integration_id` (`integer`, required): Integration ID, from callingly_integrations_list. Example: 5

Example input: `{"integration_id":5}`

### `callingly_integrations_list`

List Integrations · Read-only

List the account's connected lead-source integrations.
Returns each integration's ID and name.
Use callingly_integrations_list to find an integration for callingly_integration_routing_get. Needs an owner or admin API key.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1

Example input: `{}`

### `callingly_lead_get`

Get Lead · Read-only

Get one lead by ID.
Returns the lead's contact details, status, result, stage, team, owner, stop and block flags and custom fields (in custom, keyed by slug).
Use callingly_lead_get when you know the ID. Use callingly_leads_list to search.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lead_id` (`integer`, required): Lead ID, from callingly_leads_list. Example: 1

Example input: `{"lead_id":1}`

### `callingly_leads_list`

List Leads · Read-only

List leads created in a date range, optionally by phone number.
Returns leads with contact details, status, result, team, tags, owner, calls and next scheduled call.
Use callingly_leads_list to find a lead. Use callingly_lead_get for custom fields.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
- `end` (`string`, optional): End date, YYYY-MM-DD. Example: 2026-11-16
- `phone_number` (`string`, optional): Only leads with this phone number, E.164. Example: +14801234567
- `start` (`string`, optional): Start date, YYYY-MM-DD. Example: 2026-11-01

Example input: `{}`

### `callingly_sequence_get`

Get Sequence · Read-only

Get one follow-up sequence with its steps.
Returns during_steps (while the team is available) and outside_steps (after hours).
Use callingly_sequence_get before callingly_sequence_update. Needs an owner, admin or manager API key.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sequence_id` (`integer`, required): Sequence ID, from callingly_sequences_list. Example: 456

Example input: `{"sequence_id":456}`

### `callingly_sequences_list`

List Sequences · Read-only

List follow-up sequences (the steps run for each lead).
Returns each sequence's ID and name.
Use callingly_sequences_list to get a sequence_id for callingly_call_create or routing. Needs an owner, admin or manager API key.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1

Example input: `{}`

### `callingly_sms_list`

List SMS · Read-only

List text messages in a date range (default the last 29 days), newest first, optionally for one lead, conversation or direction.
Returns a page of messages with from, to, body, direction and time, plus paging metadata.
Use callingly_sms_list to export message history. Use callingly_conversation_messages_list for one thread.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
- `conversation_id` (`integer`, optional): Only messages in this conversation. Example: 42
- `direction` (`string`, optional): inbound or outbound. One of: inbound, outbound. Example: inbound. One of: `inbound`, `outbound`.
- `end` (`string`, optional): End date (inclusive), YYYY-MM-DD. Example: 2026-11-16
- `lead_id` (`integer`, optional): Only messages with this lead. Example: 1
- `limit` (`integer`, optional): Results per page, default 10, at most 100. Example: 25
- `page` (`integer`, optional): Page number, starting at 1. Example: 1
- `start` (`string`, optional): Start date, YYYY-MM-DD, in the account's time zone. Example: 2026-11-01

Example input: `{}`

### `callingly_team_agents_list`

List Team Agents · Read-only

List the agents (users) in a team with their priority and call cap.
Returns each agent's ID, name, priority and cap.
Use callingly_team_agents_list to see who takes a team's calls.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`integer`, required): Team ID, from callingly_teams_list. Example: 123

Example input: `{"team_id":123}`

### `callingly_team_get`

Get Team · Read-only

Get one team's settings.
Returns the team's call mode, recording, whisper text, retry schedules, SMS settings and whether agents are available now.
Use callingly_team_get to check a team's configuration or availability.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`integer`, required): Team ID, from callingly_teams_list. Example: 123

Example input: `{"team_id":123}`

### `callingly_teams_list`

List Teams · Read-only

List the call teams in the account.
Returns each team's ID, name and call settings.
Use callingly_teams_list to get a team_id for callingly_call_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1

Example input: `{}`

### `callingly_webhook_get`

Get Webhook · Read-only

Get one webhook.
Returns its event, target URL, filters and status.
Use callingly_webhook_get when you know the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`integer`, required): Webhook ID, from callingly_webhooks_list. Example: 1122

Example input: `{"webhook_id":1122}`

### `callingly_webhooks_list`

List Webhooks · Read-only

List the account's webhooks.
Returns each webhook's event, target URL, filters, active flag and failure count.
Use callingly_webhooks_list to check webhooks; one disabled after 100 failures shows is_auto_disabled.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1

Example input: `{}`

### `callingly_agent_create`

Create Agent · Write

Create a user (agent) who can take calls.
Returns the created agent with its ID.
Use callingly_agent_create to add a rep, then add them to a team with callingly_team_agents_update.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `fname` (`string`, required): First name. Example: John
- `phone_number` (`string`, required): Phone the agent is called on. Example: +16025550123
- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
- `ext` (`string`, optional): Extension to dial after connecting. Example: 100
- `lname` (`string`, optional): Last name. Example: Smith
- `timezone` (`string`, optional): IANA time zone. Example: America/Phoenix

Example input: `{"fname":"<fname>","phone_number":"<phone_number>"}`

### `callingly_agent_schedule_update`

Update Agent Schedule · Write

Replace an agent's weekly availability schedule.
Returns the updated schedule.
Use callingly_agent_schedule_update to change working hours; send all seven days.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `agent_id` (`integer`, required): Agent ID, from callingly_agents_list. Example: 123
- `schedule` (`array`, required): Seven entries, one per weekday (day 0 is Sunday), each with label, day, is_available and times (start and end as HH:MM:SS, or start allday). Example: [{"label": "Monday", "day": 1, "is_available": true, "times": [{"start": "09:00:00", "end": "17:00:00"}]}]

Example input: `{"agent_id":123,"schedule":[]}`

### `callingly_agent_update`

Update Agent · Write

Update an agent's details or do-not-disturb setting.
Returns the updated agent.
Use callingly_agent_update to pause an agent's calls (donotdisturb) or change their phone.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `agent_id` (`integer`, required): Agent ID, from callingly_agents_list. Example: 123
- `donotdisturb` (`integer`, optional): 1 stops calls to the agent, 0 resumes them. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `donotdisturb_until` (`string`, optional): When do-not-disturb ends, YYYY-MM-DD HH:MM:SS. Example: 2026-11-17 08:00:00
- `ext` (`string`, optional): Extension to dial after connecting. Example: 100
- `fname` (`string`, optional): First name. Example: John
- `lname` (`string`, optional): Last name. Example: Smith
- `phone_number` (`string`, optional): Phone the agent is called on. Example: +16025550123
- `timezone` (`string`, optional): IANA time zone. Example: America/Phoenix

Example input: `{"agent_id":123}`

### `callingly_call_create`

Create Call · Write

Create a lead and have Callingly call it: the team decides who is called, when and from which caller ID, and the lead is enrolled in a follow-up sequence.
Returns the created call and lead.
Use callingly_call_create to push a new lead for an immediate or scheduled callback. Use callingly_sms_create to text a lead instead.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `phone_number` (`string`, required): Lead's phone number. Example: +15555550123
- `team_id` (`integer`, required): Team that handles the call, from callingly_teams_list. Example: 123
- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
- `category` (`string`, optional): Lead category. Example: Pools
- `company` (`string`, optional): Lead's company. Example: John's Pools
- `crm_id` (`string`, optional): The lead's ID in your CRM. Example: 123
- `email` (`string`, optional): Lead's email. Example: john@example.com
- `first_name` (`string`, optional): Lead's first name. Example: John
- `last_name` (`string`, optional): Lead's last name. Example: Doe
- `scheduled_at` (`string`, optional): Schedule the call for later, YYYY-MM-DD HH:MM:SS in the account's time zone. Example: 2026-11-17 14:30:00
- `sequence_id` (`integer`, optional): Follow-up sequence to enroll the lead in, from callingly_sequences_list; defaults to the team's sequence. Example: 456
- `source` (`string`, optional): Where the lead came from. Example: HubSpot

Example input: `{"phone_number":"<phone_number>","team_id":123}`

### `callingly_client_active_set`

Activate or Deactivate Client · Write

Activate or deactivate an agency client account (agency partners only).
Returns the client's status.
Use callingly_client_active_set to pause or restore a client's service.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`integer`, required): Client ID, from callingly_clients_list. Example: 123
- `is_active` (`integer`, required): 1 activates the client, 0 deactivates it. One of: 0, 1. Example: 0. One of: `0`, `1`.

Example input: `{"client_id":123,"is_active":0}`

### `callingly_integration_routing_update`

Update Integration Routing · Write

Replace an integration's routing rules and default team or sequence; fields left out keep their value.
Returns the updated routing.
Use callingly_integration_routing_update to send leads matching conditions to a different team or sequence, or to ignore them. Needs an owner or admin API key.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `integration_id` (`integer`, required): Integration ID, from callingly_integrations_list. Example: 5
- `rules` (`array`, optional): Ordered rules; the first match wins. Each has field, operator (equals, contains, starts_with, ends_with, is_any_of, greater_than, greater_than_or_equal_to, less_than, less_than_or_equal_to, between with value2), value, optional extra conditions, action (redirect to team_id or ignore) and optional sequence_id. Example: [{"field": "source", "operator": "equals", "value": "Realtor.com", "action": "redirect", "team_id": 11}]
- `sequence_id` (`integer`, optional): Default sequence for leads no rule matches; empty for the team's own. Example: 456
- `team_id` (`integer`, optional): Default team for leads no rule matches. Example: 10

Example input: `{"integration_id":5}`

### `callingly_lead_update`

Update Lead · Write

Update a lead's details, status, result, stage, stop or block flags, or custom fields.
Returns the updated lead.
Use callingly_lead_update to change a lead or stop its follow-ups (is_stopped). Custom fields go in custom, keyed by slug.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lead_id` (`integer`, required): Lead ID, from callingly_leads_list. Example: 1
- `company` (`string`, optional): Company. Example: Callingly
- `custom` (`object`, optional): Custom lead fields keyed by slug; keys that are not custom fields of the account are ignored. Example: {"contract_proposal_url": "https://example.com/proposal"}
- `email` (`string`, optional): Email. Example: test@lead.com
- `fname` (`string`, optional): First name. Example: Test
- `is_blocked` (`integer`, optional): 1 blocks the lead's number, 0 unblocks it. One of: 0, 1. Example: 0. One of: `0`, `1`.
- `is_stopped` (`integer`, optional): 1 stops further calls and texts to the lead, 0 resumes them. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `lname` (`string`, optional): Last name. Example: Lead
- `phone_number` (`string`, optional): Phone number. Example: +14801234567
- `result` (`string`, optional): Call result. Example: appointment set
- `source` (`string`, optional): Lead source. Example: Webhook
- `stage` (`string`, optional): Pipeline stage. Example: qualified
- `status` (`string`, optional): Lead status. Example: contacted

Example input: `{"lead_id":1}`

### `callingly_sequence_update`

Update Sequence · Write

Replace a sequence's steps for business hours, after hours, or both; a list left out is kept.
Returns the updated sequence.
Use callingly_sequence_update to change follow-up cadence. Needs an owner, admin or manager API key.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sequence_id` (`integer`, required): Sequence ID, from callingly_sequences_list. Example: 456
- `during_steps` (`array`, optional): Steps while the team is available. Types: wait (unit immediately, minutes, hours, days or same_day, with value and time), ai-call, call (a rep is called first) and sms (with body). Example: [{"type": "ai-call"}, {"type": "wait", "unit": "hours", "value": 2}, {"type": "ai-call"}]
- `outside_steps` (`array`, optional): Steps after hours, same step types. Example: [{"type": "wait", "unit": "days", "value": 1, "time": "08:00"}, {"type": "call"}]

Example input: `{"sequence_id":456}`

### `callingly_sms_create`

Send SMS · Write

Send a text message to a lead from one of your Callingly numbers; merge tags such as {{lead.first_name}} are filled in.
Returns the sent message with lead_id, conversation_id and sms_id.
Use callingly_sms_create to text now. Use callingly_sms_schedule to send later.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `message` (`string`, required): Message text; may contain merge tags. Example: Hi {{lead.first_name}}, thanks for your inquiry. We'll call you shortly. Reply STOP to opt out.
- `phone_number` (`string`, required): Lead's phone number, E.164 preferred. Example: +11234567890
- `sms_number` (`string`, required): Your Callingly number to send from, E.164 preferred. Example: +11239876543

Example input: `{"message":"<message>","phone_number":"<phone_number>","sms_number":"<sms_number>"}`

### `callingly_sms_schedule`

Schedule SMS · Write

Queue a text to an existing lead for a future time; merge tags are filled in when it is sent.
Returns the scheduled message with scheduled_sms_id and the send time in UTC.
Use callingly_sms_schedule for a later follow-up. Use callingly_sms_create to send now.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `message` (`string`, required): Message text; may contain merge tags. Example: Hi {{lead.first_name}}, just checking in!
- `phone_number` (`string`, required): Lead's phone number, E.164 preferred. Example: +11234567890
- `send_at` (`string`, required): When to send, YYYY-MM-DD HH:MM in the account's time zone; a past time sends right away. Example: 2026-11-17 09:00
- `sms_number` (`string`, required): Your Callingly number to send from, E.164 preferred. Example: +11239876543

Example input: `{"message":"<message>","phone_number":"<phone_number>","send_at":"<send_at>","sms_number":"<sms_number>"}`

### `callingly_team_agent_settings_update`

Update Team Agent Settings · Write

Set an agent's priority and call cap within a team.
Returns the updated settings.
Use callingly_team_agent_settings_update to change call order or limit how many calls an agent gets.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `agent_id` (`integer`, required): Agent ID, from callingly_team_agents_list. Example: 3
- `team_id` (`integer`, required): Team ID, from callingly_teams_list. Example: 123
- `cap` (`integer`, optional): Maximum calls for the agent; empty for no cap. Example: 100
- `priority` (`integer`, optional): Call priority within the team; 1 is called first. Example: 1

Example input: `{"agent_id":3,"team_id":123}`

### `callingly_team_agents_update`

Set Team Agents · Write

Set which agents belong to a team; the list replaces the current members.
Returns the team's agents.
Use callingly_team_agents_update to add or remove several agents at once. Use callingly_team_agent_remove for one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `agents` (`array`, required): Agent (user) IDs to put in the team, from callingly_agents_list. Example: ["1", "3", "5"]
- `team_id` (`integer`, required): Team ID, from callingly_teams_list. Example: 123

Example input: `{"agents":["1","3","5"],"team_id":123}`

### `callingly_team_create`

Create Team · Write

Create a call team.
Returns the created team with its ID.
Use callingly_team_create to route a new lead source to a different group of agents; add agents with callingly_team_agents_update.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Team name. Example: New Team
- `account_id` (`integer`, optional): Agency partners only: the client account to act on, from callingly_clients_list. Leave empty for your own account. Example: 1
- `call_mode` (`string`, optional): How agents are called, for example simultaneous. Example: simultaneous
- `delay` (`integer`, optional): Seconds to wait before calling. Example: 0
- `is_record` (`integer`, optional): 1 records calls, 0 does not. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `is_reschedule` (`integer`, optional): 1 lets agents reschedule calls. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `is_retry` (`integer`, optional): 1 retries agents who do not answer. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `is_retry_lead` (`integer`, optional): 1 retries leads who do not answer. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `language` (`string`, optional): Language of the whisper and prompts. Example: en
- `lead_retries` (`integer`, optional): Number of lead retries. Example: 3
- `lead_retry_schedule` (`array`, optional): Minutes between lead retries. Example: [15, 60, 120]
- `retries` (`integer`, optional): Number of agent retries. Example: 3
- `retry_schedule` (`array`, optional): Minutes between agent retries. Example: [15, 60, 120]
- `sequence_id` (`integer`, optional): Default follow-up sequence for the team, from callingly_sequences_list. Example: 12
- `whispertext` (`string`, optional): Message the agent hears before being connected; may use {first_name}, {last_name}, {company}, {category}. Example: Press 1 to connect to {first_name} {last_name} from {company}

Example input: `{"name":"<name>"}`

### `callingly_team_update`

Update Team · Write

Update a team's name or call settings.
Returns the updated team.
Use callingly_team_update to change recording, retries, whisper text or the default sequence.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`integer`, required): Team ID, from callingly_teams_list. Example: 123
- `call_mode` (`string`, optional): How agents are called, for example simultaneous. Example: simultaneous
- `delay` (`integer`, optional): Seconds to wait before calling. Example: 0
- `is_record` (`integer`, optional): 1 records calls, 0 does not. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `is_reschedule` (`integer`, optional): 1 lets agents reschedule calls. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `is_retry` (`integer`, optional): 1 retries agents who do not answer. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `is_retry_lead` (`integer`, optional): 1 retries leads who do not answer. One of: 0, 1. Example: 1. One of: `0`, `1`.
- `language` (`string`, optional): Language of the whisper and prompts. Example: en
- `lead_retries` (`integer`, optional): Number of lead retries. Example: 3
- `lead_retry_schedule` (`array`, optional): Minutes between lead retries. Example: [15, 60, 120]
- `name` (`string`, optional): Team name. Example: Main Team
- `retries` (`integer`, optional): Number of agent retries. Example: 3
- `retry_schedule` (`array`, optional): Minutes between agent retries. Example: [15, 60, 120]
- `sequence_id` (`integer`, optional): Default follow-up sequence for the team, from callingly_sequences_list. Example: 12
- `whispertext` (`string`, optional): Message the agent hears before being connected; may use {first_name}, {last_name}, {company}, {category}. Example: Press 1 to connect to {first_name} {last_name} from {company}

Example input: `{"team_id":123}`

### `callingly_webhook_create`

Create Webhook · Write

Create a webhook that posts call or lead events to a URL.
Returns the created webhook.
Use callingly_webhook_create to push completed calls or lead changes to another system.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `event` (`string`, required): Event to send. One of: call_completed, lead_created, lead_updated. Example: call_completed. One of: `call_completed`, `lead_created`, `lead_updated`.
- `name` (`string`, required): Webhook name. Example: My Webhook
- `target_url` (`string`, required): URL that receives the events. Example: https://example.com/hooks/callingly
- `call_direction` (`string`, optional): call_completed only: outbound or inbound. One of: outbound, inbound. Example: outbound. One of: `outbound`, `inbound`.
- `call_lead_status` (`string`, optional): call_completed only: contacted, missed, removed or voicemail. One of: contacted, missed, removed, voicemail. Example: contacted. One of: `contacted`, `missed`, `removed`, `voicemail`.
- `call_status` (`string`, optional): call_completed only: completed, missed or offline. One of: completed, missed, offline. Example: completed. One of: `completed`, `missed`, `offline`.
- `field` (`string`, optional): lead_created/lead_updated only: trigger only when this lead field changes: lead_owner, result, stage, status or tags. One of: lead_owner, result, stage, status, tags. Example: stage. One of: `lead_owner`, `result`, `stage`, `status`, `tags`.
- `filter` (`string`, optional): lead_created/lead_updated only: trigger only for leads with this value in field. Example: called
- `number_id` (`integer`, optional): call_completed inbound only: only calls to this number. Example: 456
- `team_id` (`integer`, optional): call_completed outbound only: only calls for this team. Example: 123

Example input: `{"event":"call_completed","name":"<name>","target_url":"<target_url>"}`

### `callingly_webhook_update`

Update Webhook · Write

Update a webhook; only the fields you send change. Setting is_active to true re-enables an auto-disabled webhook and resets its failure count.
Returns the updated webhook.
Use callingly_webhook_update to change filters or re-enable a webhook.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`integer`, required): Webhook ID, from callingly_webhooks_list. Example: 1122
- `call_direction` (`string`, optional): call_completed only: outbound or inbound. One of: outbound, inbound. Example: outbound. One of: `outbound`, `inbound`.
- `call_lead_status` (`string`, optional): call_completed only: contacted, missed, removed or voicemail. One of: contacted, missed, removed, voicemail. Example: contacted. One of: `contacted`, `missed`, `removed`, `voicemail`.
- `call_status` (`string`, optional): call_completed only: completed, missed or offline. One of: completed, missed, offline. Example: completed. One of: `completed`, `missed`, `offline`.
- `event` (`string`, optional): Event to send. One of: call_completed, lead_created, lead_updated. Example: call_completed. One of: `call_completed`, `lead_created`, `lead_updated`.
- `field` (`string`, optional): lead_created/lead_updated only: trigger only when this lead field changes: lead_owner, result, stage, status or tags. One of: lead_owner, result, stage, status, tags. Example: stage. One of: `lead_owner`, `result`, `stage`, `status`, `tags`.
- `filter` (`string`, optional): lead_created/lead_updated only: trigger only for leads with this value in field. Example: called
- `is_active` (`boolean`, optional): true to enable, false to disable. Example: true
- `name` (`string`, optional): Webhook name. Example: My Webhook
- `number_id` (`integer`, optional): call_completed inbound only: only calls to this number. Example: 456
- `target_url` (`string`, optional): URL that receives the events. Example: https://example.com/hooks/callingly
- `team_id` (`integer`, optional): call_completed outbound only: only calls for this team. Example: 123

Example input: `{"webhook_id":1122}`

### `callingly_agent_delete`

Delete Agent · Destructive

Delete a user (agent).
Returns a confirmation.
Use callingly_agent_delete to remove a rep who left. Use callingly_agent_update with donotdisturb to pause them instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `agent_id` (`integer`, required): Agent ID, from callingly_agents_list. Example: 123

Example input: `{"agent_id":123}`

### `callingly_lead_delete`

Delete Lead · Destructive

Delete a lead.
Returns success true.
Use callingly_lead_delete to remove a lead. Use callingly_lead_update with is_stopped to stop calling it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `lead_id` (`integer`, required): Lead ID, from callingly_leads_list. Example: 1

Example input: `{"lead_id":1}`

### `callingly_team_agent_remove`

Remove Team Agent · Destructive

Remove one agent from a team.
Returns a confirmation.
Use callingly_team_agent_remove to take an agent off a team's calls.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `agent_id` (`integer`, required): Agent ID, from callingly_team_agents_list. Example: 3
- `team_id` (`integer`, required): Team ID, from callingly_teams_list. Example: 123

Example input: `{"agent_id":3,"team_id":123}`

### `callingly_webhook_delete`

Delete Webhook · Destructive

Delete a webhook.
Returns a confirmation.
Use callingly_webhook_delete to stop sending events. Use callingly_webhook_update with is_active false to pause instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`integer`, required): Webhook ID, from callingly_webhooks_list. Example: 1122

Example input: `{"webhook_id":1122}`

## Related

Other CRM & Sales connectors ([all 174](/agentkit/connectors/?category=crm-sales)):

- [Salesforce](/agentkit/connectors/salesforce/): Scalekit connector, OAuth, 74 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Close](/agentkit/connectors/close/): Scalekit connector, OAuth, 103 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
